Pen Oluşturucular

Tanım

Ad Alanı:

System.Drawing

Bütünleştirilmiş Kod:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v11.0.0-preview.5.26302.115

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

Aşırı Yüklemeler

Name	Description
Pen(Brush)	belirtilen Penile sınıfının yeni bir örneğini Brush başlatır.
Pen(Color)	Belirtilen renkle Pen sınıfının yeni bir örneğini başlatır.
Pen(Brush, Single)	Belirtilen Pen ve Brushile Width sınıfının yeni bir örneğini başlatır.
Pen(Color, Single)	Belirtilen Pen ve Color özellikleriyle Width sınıfının yeni bir örneğini başlatır.

Pen(Brush)

Kaynak:

Pen.cs

belirtilen Penile sınıfının yeni bir örneğini Brush 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'e eşittir.

Örnekler

Aşağıdaki kod örneği, Pen ile bir Brush oluşturmayı ve LineJoinPen özelliğini ayarlamanın 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 olarak geçirerek ePaintEventArgsçağırın.

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.

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

Pen(Color)

Kaynak:

Pen.cs

Belirtilen renkle Pen sınıfının yeni bir örneğini 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.

Pen(Brush, Single)

Kaynak:

Pen.cs

Belirtilen Pen ve Brushile Width sınıfının yeni bir örneğini 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'e eşittir.

Örnekler

Aşağıdaki kod örneği bir Pen oluşturur ve üzerinde StartCapve EndCap özelliklerini ayarlamanın Pen 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 olarak geçirerek ePaintEventArgsçağırın.

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 Colorözelliğini de belirttiğine Pen dikkat edin.

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.

Pen(Color, Single)

Kaynak:

Pen.cs

Belirtilen Pen ve Color özellikleriyle Width sınıfının yeni bir örneğini 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 değer.

Örnekler

Aşağıdaki kod örneği, ve Pen oluşturma işleminin , DashCapve DashPattern özelliklerini ayarlamanın SmoothingModeetkilerini gösterir.

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.