Pen Konstruktor

Definisi

Ruang nama:

System.Drawing

Rakitan:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Menginisialisasi instans Pen baru kelas dengan warna yang ditentukan.

Overload

Pen(Brush)	Menginisialisasi instans Pen baru kelas dengan yang ditentukan Brush.
Pen(Color)	Menginisialisasi instans Pen baru kelas dengan warna yang ditentukan.
Pen(Brush, Single)	Menginisialisasi instans Pen baru kelas dengan yang ditentukan Brush dan Width.
Pen(Color, Single)	Menginisialisasi instans Pen baru kelas dengan properti dan Width yang ditentukanColor.

Pen(Brush)

Sumber:

Pen.cs

Menginisialisasi instans Pen baru kelas dengan yang ditentukan 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)

Parameter

brush

Brush

Brush yang menentukan properti isian ini Pen.

Pengecualian

ArgumentNullException

brushadalah null.

Contoh

Contoh kode berikut menunjukkan pembuatan Pen dengan Brush dan efek mengatur LineJoin properti pada Pen.

Contoh ini dirancang untuk digunakan dengan Formulir Windows. Tempelkan kode ke dalam formulir dan panggil ShowLineJoin metode saat menangani peristiwa formulir Paint , meneruskan e sebagai 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

Keterangan

Properti Brush menentukan bagaimana Pen garis gambar. Garis digambar seolah-olah persegi panjang terisi, dengan karakteristik yang ditentukan Brush.

Width Properti baru Pen diatur ke 1 (default).

Pen(Color)

Sumber:

Pen.cs

Menginisialisasi instans Pen baru kelas dengan warna yang ditentukan.

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)

Parameter

color

Color

Struktur Color yang menunjukkan warna ini Pen.

Keterangan

Properti Color diatur ke warna yang ditentukan oleh color parameter . Properti Width diatur ke 1 (default).

Pen(Brush, Single)

Sumber:

Pen.cs

Menginisialisasi instans Pen baru kelas dengan yang ditentukan Brush dan 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)

Parameter

brush

Brush

A Brush yang menentukan karakteristik ini Pen.

width

Single

Lebar baru Pen.

Pengecualian

ArgumentNullException

brushadalah null.

Contoh

Contoh kode berikut membuat Pen dan menunjukkan efek pengaturan StartCap properti dan EndCap pada Pen.

Contoh ini dirancang untuk digunakan dengan Formulir Windows. Tempelkan kode ke dalam formulir dan panggil ShowStartAndEndCaps metode saat menangani peristiwa formulir Paint , meneruskan e sebagai PaintEventArgs.

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

Keterangan

Brush diatur ke warna yang ditentukan dalam brush parameter, Width properti diatur ke nilai yang ditentukan dalam width parameter, dan unit diatur ke World.

Perhatikan bahwa brush parameter juga menentukan Color properti dari ini Pen.

Jika nilai ini adalah 0, lebar dalam unit perangkat selalu 1 piksel— nilai tersebut tidak terpengaruh oleh operasi transformasi skala yang berlaku untuk objek Grafis tempat Pen digunakan.

Pen(Color, Single)

Sumber:

Pen.cs

Menginisialisasi instans Pen baru kelas dengan properti dan Width yang ditentukanColor.

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)

Parameter

color

Color

Struktur Color yang menunjukkan warna ini Pen.

width

Single

Nilai yang menunjukkan lebar ini Pen.

Contoh

Contoh kode berikut menunjukkan pembuatan Pen dan efek pengaturan DashCapproperti , DashPattern, dan SmoothingMode .

Contoh ini dirancang untuk digunakan dengan Formulir Windows. Tempelkan kode ke dalam formulir dan panggil ShowPensAndSmoothingMode metode saat menangani peristiwa formulir Paint , meneruskan e sebagai 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

Keterangan

Properti Color diatur ke warna yang ditentukan oleh color parameter . Properti Width diatur ke nilai yang ditentukan dalam width parameter . Jika nilai ini adalah 0, lebar dalam unit perangkat selalu 1 piksel— nilai tersebut tidak terpengaruh oleh operasi transformasi skala yang berlaku untuk objek Grafis tempat Pen digunakan.