Pen Pen Pen Pen Class

定義

直線および曲線の描画に使用するオブジェクトを定義します。Defines an object used to draw lines and curves. このクラスは継承できません。This class cannot be inherited.

public ref class Pen sealed : MarshalByRefObject, ICloneable, IDisposable
public sealed class Pen : MarshalByRefObject, ICloneable, IDisposable
type Pen = class
    inherit MarshalByRefObject
    interface ICloneable
    interface IDisposable
Public NotInheritable Class Pen
Inherits MarshalByRefObject
Implements ICloneable, IDisposable
継承
実装

コード例を次に示しますを構築する、Penで、Brushと設定の効果、LineJoinプロパティをPenします。The following code example demonstrates constructing a Pen with a Brush and the effects of setting the LineJoin property on a Pen.

この例は、Windows フォームで使用する設計されています。This example is designed to be used with Windows Forms. フォームと呼び出しにコードを貼り付けます、ShowLineJoinメソッド、フォームを処理するときにPaint渡すイベントeとしてPaintEventArgsします。Paste the code into a form and call the ShowLineJoin method when handling the form's Paint event, passing e as PaintEventArgs.

private:
   void ShowLineJoin( PaintEventArgs^ e )
   {
      // Create a new pen.
      Pen^ skyBluePen = gcnew Pen( Brushes::DeepSkyBlue );

      // Set the pen's width.
      skyBluePen->Width = 8.0F;

      // Set the LineJoin property.
      skyBluePen->LineJoin = System::Drawing::Drawing2D::LineJoin::Bevel;

      // Draw a rectangle.
      e->Graphics->DrawRectangle( skyBluePen, Rectangle(40,40,150,200) );

      //Dispose of the pen.
      delete skyBluePen;
   }
private void ShowLineJoin(PaintEventArgs e)
{

    // Create a new pen.
    Pen skyBluePen = new Pen(Brushes.DeepSkyBlue);

    // Set the pen's width.
    skyBluePen.Width = 8.0F;

    // Set the LineJoin property.
    skyBluePen.LineJoin = System.Drawing.Drawing2D.LineJoin.Bevel;

    // Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, 
        new Rectangle(40, 40, 150, 200));

    //Dispose of the pen.
    skyBluePen.Dispose();

}
Private Sub ShowLineJoin(ByVal e As PaintEventArgs)

    ' Create a new pen.
    Dim skyBluePen As New Pen(Brushes.DeepSkyBlue)

    ' Set the pen's width.
    skyBluePen.Width = 8.0F

    ' Set the LineJoin property.
    skyBluePen.LineJoin = Drawing2D.LineJoin.Bevel

    ' Draw a rectangle.
    e.Graphics.DrawRectangle(skyBluePen, _
        New Rectangle(40, 40, 150, 200))

    'Dispose of the pen.
    skyBluePen.Dispose()

End Sub

注釈

APen指定した幅とスタイルの線を描画します。A Pen draws a line of specified width and style. 使用して、DashStyleプロパティをいくつかの種類の破線を描画します。Use the DashStyle property to draw several varieties of dashed lines. によって描画される直線をPenさまざまな塗りつぶしスタイル、純色、テクスチャなどで塗りつぶすことができます。The line drawn by a Pen can be filled in a variety of fill styles, including solid colors and textures. 塗りつぶしのスタイルは、ブラシまたはテクスチャの塗りつぶしオブジェクトとして使用されているかによって異なります。The fill style depends on brush or texture that is used as the fill object.

コンストラクター

Pen(Brush) Pen(Brush) Pen(Brush) Pen(Brush)

Pen を指定して、Brush クラスの新しいインスタンスを初期化します。Initializes a new instance of the Pen class with the specified Brush.

Pen(Brush, Single) Pen(Brush, Single) Pen(Brush, Single) Pen(Brush, Single)

指定した PenBrush を使用して、Width クラスの新しいインスタンスを初期化します。Initializes a new instance of the Pen class with the specified Brush and Width.

Pen(Color) Pen(Color) Pen(Color) Pen(Color)

指定した色を使用して、Pen クラスの新しいインスタンスを初期化します。Initializes a new instance of the Pen class with the specified color.

Pen(Color, Single) Pen(Color, Single) Pen(Color, Single) Pen(Color, Single)

指定の Pen プロパティと Color プロパティで Width クラスの新しいインスタンスを初期化します。Initializes a new instance of the Pen class with the specified Color and Width properties.

プロパティ

Alignment Alignment Alignment Alignment

Pen の配置を取得または設定します。Gets or sets the alignment for this Pen.

Brush Brush Brush Brush

この Brush の属性を決定する Pen を取得または設定します。Gets or sets the Brush that determines attributes of this Pen.

Color Color Color Color

この Pen の色を取得または設定します。Gets or sets the color of this Pen.

CompoundArray CompoundArray CompoundArray CompoundArray

複合ペンを指定する値の配列を取得または設定します。Gets or sets an array of values that specifies a compound pen. 複合ペンでは、平行線と空白で構成される複合直線を描画します。A compound pen draws a compound line made up of parallel lines and spaces.

CustomEndCap CustomEndCap CustomEndCap CustomEndCap

この Pen で描画された直線の終点で使用する、カスタム キャップを取得または設定します。Gets or sets a custom cap to use at the end of lines drawn with this Pen.

CustomStartCap CustomStartCap CustomStartCap CustomStartCap

この Pen で描画された直線の始点で使用する、カスタム キャップを取得または設定します。Gets or sets a custom cap to use at the beginning of lines drawn with this Pen.

DashCap DashCap DashCap DashCap

この Pen で描画された破線で構成されるダッシュの終点で使用する、キャップ スタイルを取得または設定します。Gets or sets the cap style used at the end of the dashes that make up dashed lines drawn with this Pen.

DashOffset DashOffset DashOffset DashOffset

直線の始点からダッシュ パターンの始点までの距離を取得または設定します。Gets or sets the distance from the start of a line to the beginning of a dash pattern.

DashPattern DashPattern DashPattern DashPattern

カスタム ダッシュと空白の配列を取得または設定します。Gets or sets an array of custom dashes and spaces.

DashStyle DashStyle DashStyle DashStyle

この Pen で描画される破線で使用されるスタイルを取得または設定します。Gets or sets the style used for dashed lines drawn with this Pen.

EndCap EndCap EndCap EndCap

この Pen で描画された直線の終点で使用する、キャップ スタイルを取得または設定します。Gets or sets the cap style used at the end of lines drawn with this Pen.

LineJoin LineJoin LineJoin LineJoin

この Pen で描画された連続する 2 本の直線の終点の接合スタイルを取得または設定します。Gets or sets the join style for the ends of two consecutive lines drawn with this Pen.

MiterLimit MiterLimit MiterLimit MiterLimit

マイター隅の接合部の太さの限度を取得または設定します。Gets or sets the limit of the thickness of the join on a mitered corner.

PenType PenType PenType PenType

この Pen で描画される直線のスタイルを取得します。Gets the style of lines drawn with this Pen.

StartCap StartCap StartCap StartCap

この Pen で描画された直線の始点で使用する、キャップ スタイルを取得または設定します。Gets or sets the cap style used at the beginning of lines drawn with this Pen.

Transform Transform Transform Transform

この Pen のジオメトリック変換のコピーを取得または設定します。Gets or sets a copy of the geometric transformation for this Pen.

Width Width Width Width

この Pen の幅を、描画に使用される Graphics オブジェクトの単位で取得または設定します。Gets or sets the width of this Pen, in units of the Graphics object used for drawing.

メソッド

Clone() Clone() Clone() Clone()

この Pen の同一コピーを作成します。Creates an exact copy of this Pen.

CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type) CreateObjRef(Type)

リモート オブジェクトとの通信に使用するプロキシの生成に必要な情報をすべて格納しているオブジェクトを作成します。Creates an object that contains all the relevant information required to generate a proxy used to communicate with a remote object.

(Inherited from MarshalByRefObject)
Dispose() Dispose() Dispose() Dispose()

この Pen によって使用されているすべてのリソースを解放します。Releases all resources used by this Pen.

Equals(Object) Equals(Object) Equals(Object) Equals(Object)

指定したオブジェクトが、現在のオブジェクトと等しいかどうかを判断します。Determines whether the specified object is equal to the current object.

(Inherited from Object)
Finalize() Finalize() Finalize() Finalize()

オブジェクトが、ガベージ コレクションによって収集される前に、リソースの解放とその他のクリーンアップ操作の実行を試みることができるようにします。Allows an object to try to free resources and perform other cleanup operations before it is reclaimed by garbage collection.

GetHashCode() GetHashCode() GetHashCode() GetHashCode()

既定のハッシュ関数として機能します。Serves as the default hash function.

(Inherited from Object)
GetLifetimeService() GetLifetimeService() GetLifetimeService() GetLifetimeService()

対象のインスタンスの有効期間ポリシーを制御する、現在の有効期間サービス オブジェクトを取得します。Retrieves the current lifetime service object that controls the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
GetType() GetType() GetType() GetType()

現在のインスタンスの Type を取得します。Gets the Type of the current instance.

(Inherited from Object)
InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService() InitializeLifetimeService()

このインスタンスの有効期間ポリシーを制御する有効期間サービス オブジェクトを取得します。Obtains a lifetime service object to control the lifetime policy for this instance.

(Inherited from MarshalByRefObject)
MemberwiseClone() MemberwiseClone() MemberwiseClone() MemberwiseClone()

現在の Object の簡易コピーを作成します。Creates a shallow copy of the current Object.

(Inherited from Object)
MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean) MemberwiseClone(Boolean)

現在の MarshalByRefObject オブジェクトの簡易コピーを作成します。Creates a shallow copy of the current MarshalByRefObject object.

(Inherited from MarshalByRefObject)
MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix) MultiplyTransform(Matrix)

この Pen の変換行列と指定の Matrix を乗算します。Multiplies the transformation matrix for this Pen by the specified Matrix.

MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder) MultiplyTransform(Matrix, MatrixOrder)

この Pen の変換行列と指定の Matrix を指定の順序で乗算します。Multiplies the transformation matrix for this Pen by the specified Matrix in the specified order.

ResetTransform() ResetTransform() ResetTransform() ResetTransform()

対象の Pen のジオメトリック変換行列を単位行列にリセットします。Resets the geometric transformation matrix for this Pen to identity.

RotateTransform(Single) RotateTransform(Single) RotateTransform(Single) RotateTransform(Single)

指定した角度だけローカル ジオメトリック変換を回転します。Rotates the local geometric transformation by the specified angle. このメソッドは変換の前に回転を行います。This method prepends the rotation to the transformation.

RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder) RotateTransform(Single, MatrixOrder)

指定した順序で、指定した角度だけローカル ジオメトリック変換を回転します。Rotates the local geometric transformation by the specified angle in the specified order.

ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single) ScaleTransform(Single, Single)

指定した係数だけローカル ジオメトリック変換をスケーリングします。Scales the local geometric transformation by the specified factors. このメソッドは変換の前にスケーリング行列を適用します。This method prepends the scaling matrix to the transformation.

ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder) ScaleTransform(Single, Single, MatrixOrder)

指定した順序で、指定した係数だけローカル ジオメトリック変換をスケーリングします。Scales the local geometric transformation by the specified factors in the specified order.

SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap) SetLineCap(LineCap, LineCap, DashCap)

この Pen で描画する直線を終了させるとき、使用されるキャップのスタイルを決定する値を設定します。Sets the values that determine the style of cap used to end lines drawn by this Pen.

ToString() ToString() ToString() ToString()

現在のオブジェクトを表す文字列を返します。Returns a string that represents the current object.

(Inherited from Object)
TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single) TranslateTransform(Single, Single)

指定した寸法でローカル ジオメトリック変換を平行移動します。Translates the local geometric transformation by the specified dimensions. このメソッドは変換の前に平行移動を行います。This method prepends the translation to the transformation.

TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder) TranslateTransform(Single, Single, MatrixOrder)

指定した順序で、指定した寸法だけローカル ジオメトリック変換を平行移動します。Translates the local geometric transformation by the specified dimensions in the specified order.

適用対象