次の方法で共有


Pen コンストラクター

定義

指定した色を使用して、Pen クラスの新しいインスタンスを初期化します。

オーバーロード

Pen(Brush)

Pen を指定して、Brush クラスの新しいインスタンスを初期化します。

Pen(Color)

指定した色を使用して、Pen クラスの新しいインスタンスを初期化します。

Pen(Brush, Single)

指定された PenBrush を使用して、Width クラスの新しいインスタンスを初期化します。

Pen(Color, Single)

指定の Color プロパティと Width プロパティで Pen クラスの新しいインスタンスを初期化します。

Pen(Brush)

ソース:
Pen.cs
ソース:
Pen.cs
ソース:
Pen.cs

Pen を指定して、Brush クラスの新しいインスタンスを初期化します。

public:
 Pen(System::Drawing::Brush ^ brush);
public Pen (System.Drawing.Brush brush);
new System.Drawing.Pen : System.Drawing.Brush -> System.Drawing.Pen
Public Sub New (brush As Brush)

パラメーター

brush
Brush

この Pen の塗りつぶしプロパティを決定する Brush

例外

brushnullです。

次のコード例では、 を使用Brushして を構築しPen、 に プロパティを設定するLineJoin効果をPen示します。

この例は、Windows フォームで使用するように設計されています。 フォームにコードを貼り付け、フォームのイベントをShowLineJoin処理するときに メソッドをPaint呼び出し、 を としてPaintEventArgs渡しますe

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

注釈

プロパティは Brush 、線の描画方法を Pen 決定します。 線は、指定した の特性を持つ塗りつぶされた四角形のように描画されます Brush

新しい Pen の プロパティは Width 1 (既定値) に設定されます。

適用対象

Pen(Color)

ソース:
Pen.cs
ソース:
Pen.cs
ソース:
Pen.cs

指定した色を使用して、Pen クラスの新しいインスタンスを初期化します。

public:
 Pen(System::Drawing::Color color);
public Pen (System.Drawing.Color color);
new System.Drawing.Pen : System.Drawing.Color -> System.Drawing.Pen
Public Sub New (color As Color)

パラメーター

color
Color

この Pen の色を示す Color 構造体。

注釈

プロパティは Color 、 パラメーターで指定された色に color 設定されます。 プロパティは Width 1 (既定値) に設定されています。

適用対象

Pen(Brush, Single)

ソース:
Pen.cs
ソース:
Pen.cs
ソース:
Pen.cs

指定された PenBrush を使用して、Width クラスの新しいインスタンスを初期化します。

public:
 Pen(System::Drawing::Brush ^ brush, float width);
public Pen (System.Drawing.Brush brush, float width);
new System.Drawing.Pen : System.Drawing.Brush * single -> System.Drawing.Pen
Public Sub New (brush As Brush, width As Single)

パラメーター

brush
Brush

この Pen の特性を決定する Brush

width
Single

新しい Pen の幅。

例外

brushnullです。

次のコード例では、 をPen作成し、 プロパティと EndCap プロパティを に設定するStartCap効果をPen示します。

この例は、Windows フォームで使用するように設計されています。 フォームにコードを貼り付け、フォームのイベントをShowStartAndEndCaps処理するときに メソッドをPaint呼び出し、 を としてPaintEventArgs渡しますe

private:
   void Button3_Click( System::Object^ /*sender*/, System::EventArgs^ /*e*/ )
   {
      Graphics^ buttonGraphics = Button3->CreateGraphics();
      Pen^ myPen = gcnew Pen( Color::ForestGreen,4.0F );
      myPen->DashStyle = System::Drawing::Drawing2D::DashStyle::DashDotDot;
      Rectangle theRectangle = Button3->ClientRectangle;
      theRectangle.Inflate(  -2, -2 );
      buttonGraphics->DrawRectangle( myPen, theRectangle );
      delete buttonGraphics;
      delete myPen;
   }
private void Button3_Click(System.Object sender, System.EventArgs e)
{

    Graphics buttonGraphics = Button3.CreateGraphics();
    Pen myPen = new Pen(Color.ForestGreen, 4.0F);
    myPen.DashStyle = System.Drawing.Drawing2D.DashStyle.DashDotDot;

    Rectangle theRectangle = Button3.ClientRectangle;
    theRectangle.Inflate(-2, -2);
    buttonGraphics.DrawRectangle(myPen, theRectangle);
    buttonGraphics.Dispose();
    myPen.Dispose();
}
Private Sub Button3_Click(ByVal sender As System.Object, _
    ByVal e As System.EventArgs) Handles Button3.Click

    Dim buttonGraphics As Graphics = Button3.CreateGraphics()
    Dim myPen As Pen = New Pen(Color.ForestGreen, 4.0F)
    myPen.DashStyle = Drawing2D.DashStyle.DashDotDot

    Dim theRectangle As Rectangle = Button3.ClientRectangle
    theRectangle.Inflate(-2, -2)
    buttonGraphics.DrawRectangle(myPen, theRectangle)
    buttonGraphics.Dispose()
    myPen.Dispose()
End Sub

注釈

Brushは パラメーターでbrush指定された色に設定され、Widthプロパティは パラメーターでwidth指定された値に設定され、単位は にWorld設定されます。

パラメーターでは、 brush この の プロパティも指定 Color されることに注意してください Pen

この値が 0 の場合、デバイス単位の幅は常に 1 ピクセルです。これは、 が使用される Graphics オブジェクトに対して有効なスケール変換操作の影響を Pen 受けません。

適用対象

Pen(Color, Single)

ソース:
Pen.cs
ソース:
Pen.cs
ソース:
Pen.cs

指定の Color プロパティと Width プロパティで Pen クラスの新しいインスタンスを初期化します。

public:
 Pen(System::Drawing::Color color, float width);
public Pen (System.Drawing.Color color, float width);
new System.Drawing.Pen : System.Drawing.Color * single -> System.Drawing.Pen
Public Sub New (color As Color, width As Single)

パラメーター

color
Color

この Pen の色を示す Color 構造体。

width
Single

この Pen の幅を示す値。

次のコード例では、 の作成Penと、および SmoothingMode プロパティの設定の効果をDashCapDashPattern示します。

この例は、Windows フォームで使用するように設計されています。 フォームにコードを貼り付け、フォームのイベントを処理するときに メソッドをShowPensAndSmoothingModePaint呼び出し、e を としてPaintEventArgs渡します。

private:
   void ShowPensAndSmoothingMode( PaintEventArgs^ e )
   {
      // Set the SmoothingMode property to smooth the line.
      e->Graphics->SmoothingMode = System::Drawing::Drawing2D::SmoothingMode::AntiAlias;

      // Create a new Pen object.
      Pen^ greenPen = gcnew Pen( Color::Green );

      // Set the width to 6.
      greenPen->Width = 6.0F;

      // Set the DashCap to round.
      greenPen->DashCap = System::Drawing::Drawing2D::DashCap::Round;

      // Create a custom dash pattern.
      array<Single>^temp0 = {4.0F,2.0F,1.0F,3.0F};
      greenPen->DashPattern = temp0;

      // Draw a line.
      e->Graphics->DrawLine( greenPen, 20.0F, 20.0F, 100.0F, 240.0F );

      // Change the SmoothingMode to none.
      e->Graphics->SmoothingMode = System::Drawing::Drawing2D::SmoothingMode::None;

      // Draw another line.
      e->Graphics->DrawLine( greenPen, 100.0F, 240.0F, 160.0F, 20.0F );

      // Dispose of the custom pen.
      delete greenPen;
   }
private void ShowPensAndSmoothingMode(PaintEventArgs e)
{

    // Set the SmoothingMode property to smooth the line.
    e.Graphics.SmoothingMode = 
        System.Drawing.Drawing2D.SmoothingMode.AntiAlias;

    // Create a new Pen object.
    Pen greenPen = new Pen(Color.Green);

    // Set the width to 6.
    greenPen.Width = 6.0F;

    // Set the DashCap to round.
    greenPen.DashCap = System.Drawing.Drawing2D.DashCap.Round;

    // Create a custom dash pattern.
    greenPen.DashPattern = new float[]{4.0F, 2.0F, 1.0F, 3.0F};

    // Draw a line.
    e.Graphics.DrawLine(greenPen, 20.0F, 20.0F, 100.0F, 240.0F);

    // Change the SmoothingMode to none.
    e.Graphics.SmoothingMode = 
        System.Drawing.Drawing2D.SmoothingMode.None;

    // Draw another line.
    e.Graphics.DrawLine(greenPen, 100.0F, 240.0F, 160.0F, 20.0F);

    // Dispose of the custom pen.
    greenPen.Dispose();
}
Private Sub ShowPensAndSmoothingMode(ByVal e As PaintEventArgs)

    ' Set the SmoothingMode property to smooth the line.
    e.Graphics.SmoothingMode = Drawing2D.SmoothingMode.AntiAlias

    ' Create a new Pen object.
    Dim greenPen As New Pen(Color.Green)

    ' Set the width to 6.
    greenPen.Width = 6.0F

    ' Set the DashCap to round.
    greenPen.DashCap = Drawing2D.DashCap.Round

    ' Create a custom dash pattern.
    greenPen.DashPattern = New Single() {4.0F, 2.0F, 1.0F, 3.0F}

    ' Draw a line.
    e.Graphics.DrawLine(greenPen, 20.0F, 20.0F, 100.0F, 240.0F)

    ' Change the SmoothingMode to none.
    e.Graphics.SmoothingMode = Drawing2D.SmoothingMode.None

    ' Draw another line.
    e.Graphics.DrawLine(greenPen, 100.0F, 240.0F, 160.0F, 20.0F)

    ' Dispose of the custom pen.
    greenPen.Dispose()
End Sub

注釈

プロパティは Color 、 パラメーターで指定された色に color 設定されます。 プロパティは Width 、 パラメーターで指定された値に width 設定されます。 この値が 0 の場合、デバイス単位の幅は常に 1 ピクセルです。これは、 が使用される Graphics オブジェクトに対して有効なスケール変換操作の影響を Pen 受けません。

適用対象