Pen コンストラクタ

.NET Framework クラス ライブラリ リファレンス

Pen コンストラクタ (Color, Single)

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

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    color As Color, _
    width As Single _
)

Visual Basic (使用法)

Dim color As Color
Dim width As Single

Dim instance As New Pen(color,
 width)

C#

public Pen (
    Color color,
    float width
)

C++

public:
Pen (
    Color color, 
    float width
)

J#

public Pen (
    Color color, 
    float width
)

JScript

public function Pen (
    color : Color, 
    width : float
)

パラメータ

color

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

width

この Pen の幅を示す値。

解説

Color プロパティは color パラメータで指定された色に設定されます。Width プロパティは width パラメータに指定された値に設定されます。width に 0 を指定した場合は、1 が指定されたものと見なされて Pen の描画が行われます。

使用例

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

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

Visual Basic

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

C#

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();
}

C++

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;
   }

J#

private void ShowPensAndSmoothingMode(PaintEventArgs
 e)
{
    // Set the SmoothingMode property to smooth the line.
    e.get_Graphics().set_SmoothingMode(
        System.Drawing.Drawing2D.SmoothingMode.AntiAlias);

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

    // Set the width to 6.
    greenPen.set_Width(6);

    // Set the DashCap to round.
    greenPen.set_DashCap(System.Drawing.Drawing2D.DashCap.Round);

    // Create a custom dash pattern.
    greenPen.set_DashPattern(new float[] {
 4, 2, 1, 3 });

    // Draw a line.
    e.get_Graphics().DrawLine(greenPen, 20, 20, 100, 240);

    // Change the SmoothingMode to none.
    e.get_Graphics().set_SmoothingMode(
        System.Drawing.Drawing2D.SmoothingMode.None);

    // Draw another line.
    e.get_Graphics().DrawLine(greenPen, 100, 240, 160, 20);

    // Dispose of the custom pen.
    greenPen.Dispose();
} //ShowPensAndSmoothingMode

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0

参照

関連項目
Pen クラス
Pen メンバ
System.Drawing 名前空間

Pen コンストラクタ (Brush)

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

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    brush As Brush _
)

Visual Basic (使用法)

Dim brush As Brush

Dim instance As New Pen(brush)

C#

public Pen (
    Brush brush
)

C++

public:
Pen (
    Brush^ brush
)

J#

public Pen (
    Brush brush
)

JScript

public function Pen (
    brush : Brush
)

パラメータ

brush

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

例外

例外の種類	条件
ArgumentNullException	brush が null 参照 (Visual Basic では Nothing) です。

解説

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

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

使用例

次のコード例は、Brush を使用して Pen を作成する方法と、Pen で LineJoin プロパティを設定することの効果を示しています。

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

Visual Basic

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

C#

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();

}

C++

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;
   }

J#

private void ShowLineJoin(PaintEventArgs e)
{
    // Create a new pen.
    Pen skyBluePen = new Pen(Brushes.get_DeepSkyBlue());

    // Set the pen's width.
    skyBluePen.set_Width(8);

    // Set the LineJoin property.
    skyBluePen.set_LineJoin(System.Drawing.Drawing2D.LineJoin.Bevel);

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

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Pen クラス
Pen メンバ
System.Drawing 名前空間

Pen コンストラクタ

指定した色を使用して、Pen クラスの新しいインスタンスを初期化します。
オーバーロードの一覧

名前	説明
Pen (Brush)	Brush を指定して、Pen クラスの新しいインスタンスを初期化します。
Pen (Color)	指定した色を使用して、Pen クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。
Pen (Brush, Single)	指定した Brush と Width を使用して、Pen クラスの新しいインスタンスを初期化します。
Pen (Color, Single)	指定の Color プロパティと Width プロパティで Pen クラスの新しいインスタンスを初期化します。 .NET Compact Framework によってサポートされています。

参照

関連項目

Pen クラス
Pen メンバ
System.Drawing 名前空間

Pen コンストラクタ (Brush, Single)

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

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    brush As Brush, _
    width As Single _
)

Visual Basic (使用法)

Dim brush As Brush
Dim width As Single

Dim instance As New Pen(brush,
 width)

C#

public Pen (
    Brush brush,
    float width
)

C++

public:
Pen (
    Brush^ brush, 
    float width
)

J#

public Pen (
    Brush brush, 
    float width
)

JScript

public function Pen (
    brush : Brush, 
    width : float
)

パラメータ

brush

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

width

新しい Pen の幅。

例外

例外の種類	条件
ArgumentNullException	brush が null 参照 (Visual Basic では Nothing) です。

解説

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

brush パラメータは、この Pen の Color プロパティも指定します。

width に 0 を指定した場合は、1 が指定されたものと見なされて Pen の描画が行われます。

使用例

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

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

Visual Basic

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

C#

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();
}

C++

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;
   }

J#

private void button3_Click(Object sender, System.EventArgs
 e)
{
    Graphics buttonGraphics = button3.CreateGraphics();
    Pen myPen = new Pen(Color.get_ForestGreen(), 4.0F);

    myPen.set_DashStyle(System.Drawing.Drawing2D.DashStyle.DashDotDot);

    Rectangle theRectangle = button3.get_ClientRectangle();

    theRectangle.Inflate(-2, -2);
    buttonGraphics.DrawRectangle(myPen, theRectangle);
    buttonGraphics.Dispose();
    myPen.Dispose();
} //button3_Click

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0

参照

関連項目
Pen クラス
Pen メンバ
System.Drawing 名前空間

Pen コンストラクタ (Color)

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

名前空間: System.Drawing
アセンブリ: System.Drawing (system.drawing.dll 内)
構文

Visual Basic (宣言)

Public Sub New ( _
    color As Color _
)

Visual Basic (使用法)

Dim color As Color

Dim instance As New Pen(color)

C#

public Pen (
    Color color
)

C++

public:
Pen (
    Color color
)

J#

public Pen (
    Color color
)

JScript

public function Pen (
    color : Color
)

パラメータ

color

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

解説

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

プラットフォーム

Windows 98, Windows 2000 SP4, Windows Millennium Edition, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

開発プラットフォームの中には、.NET Framework によってサポートされていないバージョンがあります。サポートされているバージョンについては、「システム要件」を参照してください。

バージョン情報

.NET Framework
サポート対象 : 2.0、1.1、1.0
.NET Compact Framework
サポート対象 : 2.0、1.0

参照

関連項目
Pen クラス
Pen メンバ
System.Drawing 名前空間