Pen Oluşturucular

  • Başvuru

Tanım

Ad Alanı:
System.Drawing
Bütünleştirilmiş Kod:
System.Drawing.Common.dll
Bütünleştirilmiş Kod:
System.Drawing.dll
Paket:
System.Drawing.Common v6.0.0
Paket:
System.Drawing.Common v7.0.0
Paket:
System.Drawing.Common v8.0.0
Paket:
System.Drawing.Common v9.0.0-preview.2.24128.3

Belirtilen renkle sınıfının yeni bir örneğini Pen başlatır.

Aşırı Yüklemeler

Pen(Brush)

belirtilen Brushile sınıfının yeni bir örneğini Pen başlatır.
Pen(Color)

Belirtilen renkle sınıfının yeni bir örneğini Pen başlatır.
Pen(Brush, Single)

belirtilen Brush ve Widthile sınıfının yeni bir örneğini Pen başlatır.
Pen(Color, Single)

Belirtilen Color ve Width özellikleriyle sınıfının yeni bir örneğini Pen başlatır.

Pen(Brush)

Kaynak:
Pen.cs
Kaynak:
Pen.cs
Kaynak:
Pen.cs

belirtilen Brushile sınıfının yeni bir örneğini Pen başlatır.

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)

Parametreler

brush
Brush

Brush Bu Penöğesinin dolgu özelliklerini belirleyen bir .

Özel durumlar

ArgumentNullException

brush, null değeridir.

Örnekler

Aşağıdaki kod örneği ile oluşturma PenBrush işlemini ve özelliğini bir Penüzerinde ayarlamanın LineJoin etkilerini gösterir.

Bu örnek, Windows Forms ile kullanılacak şekilde tasarlanmıştır. Kodu bir forma yapıştırın ve formun ShowLineJoinPaint olayını işlerken yöntemini çağırın e ve olarak geçirin 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

Açıklamalar

Brush özelliği, çizgilerin nasıl çizileceğini Pen belirler. Çizgiler, belirtilen Brushözellikleriyle doldurulmuş dikdörtgenler gibi çizilir.

Width Yeninin Pen özelliği 1 (varsayılan) olarak ayarlanır.

Şunlara uygulanır

Pen(Color)

Kaynak:
Pen.cs
Kaynak:
Pen.cs
Kaynak:
Pen.cs

Belirtilen renkle sınıfının yeni bir örneğini Pen başlatır.

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)

Parametreler

color
Color

Color Bu Penöğesinin rengini gösteren bir yapı.

Açıklamalar

Color özelliği parametresi tarafından color belirtilen renge ayarlanır. Width özelliği 1 (varsayılan) olarak ayarlanır.

Şunlara uygulanır

Pen(Brush, Single)

Kaynak:
Pen.cs
Kaynak:
Pen.cs
Kaynak:
Pen.cs

belirtilen Brush ve Widthile sınıfının yeni bir örneğini Pen başlatır.

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)

Parametreler

brush
Brush

Brush Bu Penöğesinin özelliklerini belirleyen bir .

width
Single

Yeni Penöğesinin genişliği.

Özel durumlar

ArgumentNullException

brush, null değeridir.

Örnekler

Aşağıdaki kod örneği bir Pen oluşturur ve üzerinde ve EndCap özelliklerini Penayarlamanın StartCap etkilerini gösterir.

Bu örnek, Windows Forms ile kullanılacak şekilde tasarlanmıştır. Kodu bir forma yapıştırın ve formun ShowStartAndEndCapsPaint olayını işlerken yöntemini çağırın e ve olarak geçirin 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

Açıklamalar

Brush parametresinde brush belirtilen renge ayarlanır, Width özelliği parametresinde width belirtilen değere ayarlanır ve birimler olarak Worldayarlanır.

parametresinin brush bu Penözelliğini de belirttiğini Color unutmayın.

Bu değer 0 ise, cihaz birimlerindeki genişlik her zaman 1 pikseldir; kullanıldığı Grafik nesnesi Pen için geçerli olan ölçek dönüştürme işlemlerinden etkilenmez.

Şunlara uygulanır

Pen(Color, Single)

Kaynak:
Pen.cs
Kaynak:
Pen.cs
Kaynak:
Pen.cs

Belirtilen Color ve Width özellikleriyle sınıfının yeni bir örneğini Pen başlatır.

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)

Parametreler

color
Color

Color Bu Penöğesinin rengini gösteren bir yapı.

width
Single

Bu Pendeğerinin genişliğini gösteren bir değer.

Örnekler

Aşağıdaki kod örneğinde, , DashPatternve özelliklerini ayarlamanın DashCapetkileri ve SmoothingMode oluşturma Pen işlemleri gösterilmektedir.

Bu örnek, Windows Forms ile kullanılacak şekilde tasarlanmıştır. Kodu bir forma yapıştırın ve formun ShowPensAndSmoothingMode olayını işlerken yöntemini çağırın ve e'yi Paint olarak geçirin 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

Açıklamalar

Color özelliği parametresi tarafından color belirtilen renge ayarlanır. Width özelliği parametresinde belirtilen değere width ayarlanır. Bu değer 0 ise, cihaz birimlerindeki genişlik her zaman 1 pikseldir; kullanıldığı Grafik nesnesi Pen için geçerli olan ölçek dönüştürme işlemlerinden etkilenmez.

Şunlara uygulanır