Pen Konstruktoren

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Farbe.

Überlädt

Pen(Brush)	Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Brush.
Pen(Color)	Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Farbe.
Pen(Brush, Single)	Initialisiert eine neue Instanz der Pen-Klasse mit den angegebenen Brush und dem angegebenen Width.
Pen(Color, Single)	Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Color-Eigenschaft und der angegebenen Width-Eigenschaft.

Pen(Brush)

Quelle:

Pen.cs

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen 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

Ein Brush, der die Fülleigenschaften dieses Pen bestimmt.

Ausnahmen

ArgumentNullException

brush ist null.

Beispiele

Im folgenden Codebeispiel wird das Erstellen eines Pen mit einem Brush und die Auswirkungen des Festlegens der LineJoin -Eigenschaft für ein Penveranschaulicht.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Fügen Sie den Code in ein Formular ein, und rufen Sie die ShowLineJoin -Methode auf, wenn Sie das Ereignis des Formulars Paint behandeln, und übergeben Sie e als 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

Hinweise

Die Brush -Eigenschaft bestimmt, wie linieniert Pen werden. Linien werden gezeichnet, als ob es sich um gefüllte Rechtecke handelt, mit den Merkmalen des angegebenen Brush.

Die Width -Eigenschaft des neuen Pen ist auf 1 (Standard) festgelegt.

Pen(Color)

Quelle:

Pen.cs

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Farbe.

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

Eine Color-Struktur, die die Farbe dieses Pen angibt.

Hinweise

Die Color -Eigenschaft wird auf die vom color -Parameter angegebene Farbe festgelegt. Die Width -Eigenschaft ist auf 1 (Standard) festgelegt.

Pen(Brush, Single)

Quelle:

Pen.cs

Initialisiert eine neue Instanz der Pen-Klasse mit den angegebenen Brush und dem angegebenen 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

Ein Brush, der die Merkmale dieses Pen bestimmt.

width

Single

Die Breite des neuen Pen.

Ausnahmen

ArgumentNullException

brush ist null.

Beispiele

Im folgenden Codebeispiel wird ein Pen erstellt und veranschaulicht die Auswirkungen des Festlegens der StartCap Eigenschaften und EndCap für eine Pen.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Fügen Sie den Code in ein Formular ein, und rufen Sie die ShowStartAndEndCaps -Methode auf, wenn Sie das Ereignis des Formulars Paint behandeln, und übergeben Sie e als 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

Hinweise

Brush wird auf die im brush -Parameter angegebene Farbe festgelegt, die Width -Eigenschaft wird auf den im width -Parameter angegebenen Wert festgelegt, und die Einheiten werden auf Worldfestgelegt.

Beachten Sie, dass der brush Parameter auch die Color -Eigenschaft dieses Penangibt.

Wenn dieser Wert 0 ist, beträgt die Breite in Geräteeinheiten immer 1 Pixel. Sie wird nicht durch Skalierungs-Transformationsvorgänge beeinflusst, die für das Graphics-Objekt wirksam sind, für das verwendet Pen wird.

Pen(Color, Single)

Quelle:

Pen.cs

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Color-Eigenschaft und der angegebenen Width-Eigenschaft.

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

Eine Color-Struktur, die die Farbe dieses Pen angibt.

width

Single

Ein Wert, der die Breite dieses Pen angibt.

Beispiele

Im folgenden Codebeispiel wird das Erstellen von und Pen die Auswirkungen des Festlegens der DashCapEigenschaften , DashPatternund SmoothingMode veranschaulicht.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert. Fügen Sie den Code in ein Formular ein, und rufen Sie die ShowPensAndSmoothingMode -Methode auf, wenn Sie das Ereignis des Formulars Paint behandeln, und übergeben Sie e als 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

Hinweise

Die Color -Eigenschaft wird auf die vom color -Parameter angegebene Farbe festgelegt. Die Width -Eigenschaft wird auf den im width -Parameter angegebenen Wert festgelegt. Wenn dieser Wert 0 ist, beträgt die Breite in Geräteeinheiten immer 1 Pixel. Sie wird nicht durch Skalierungs-Transformationsvorgänge beeinflusst, die für das Graphics-Objekt wirksam sind, für das verwendet Pen wird.