Pen Konstruktoren

Definition

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Farbe.Initializes a new instance of the Pen class with the specified color.

Überlädt

Pen(Brush)

Initialisiert eine neue Instanz der Pen-Klasse mit dem angegebenen Brush.Initializes a new instance of the Pen class with the specified Brush.

Pen(Color)

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Farbe.Initializes a new instance of the Pen class with the specified color.

Pen(Brush, Single)

Initialisiert eine neue Instanz der Pen-Klasse mit den angegebenen Brush und dem angegebenen Width.Initializes a new instance of the Pen class with the specified Brush and Width.

Pen(Color, Single)

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Color-Eigenschaft und der angegebenen Width-Eigenschaft.Initializes a new instance of the Pen class with the specified Color and Width properties.

Pen(Brush)

Initialisiert eine neue Instanz der Pen-Klasse mit dem angegebenen Brush.Initializes a new instance of the Pen class with the specified Brush.

public:
 Pen(System::Drawing::Brush ^ brush);
public Pen (System.Drawing.Brush brush);
new System.Drawing.Pen : System.Drawing.Brush -> System.Drawing.Pen

Parameter

brush
Brush

Ein Brush, der die Fülleigenschaften dieses Pen bestimmt.A Brush that determines the fill properties of this Pen.

Ausnahmen

brush ist null.brush is null.

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen einer Pen mit einem Brush und die Auswirkungen der Festlegung der LineJoin-Eigenschaft auf eine Pen.The following code example demonstrates constructing a Pen with a Brush and the effects of setting the LineJoin property on a Pen.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert.This example is designed to be used with Windows Forms. Fügen Sie den Code in ein Formular ein, und nennen Sie die ShowLineJoin-Methode, wenn Sie das Paint Ereignis des Formulars verarbeiten und e als PaintEventArgsübergeben.Paste the code into a form and call the ShowLineJoin method when handling the form's Paint event, passing e as 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 das Pen Linien zeichnet.The Brush property determines how the Pen draws lines. Zeilen werden als ausgefüllte Rechtecke mit den Merkmalen der angegebenen Brushgezeichnet.Lines are drawn as if they are filled rectangles, with the characteristics of the specified Brush.

Die Width-Eigenschaft der neuen Pen ist auf 1 (Standard) festgelegt.The Width property of the new Pen is set to 1 (the default).

Pen(Color)

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Farbe.Initializes a new instance of the Pen class with the specified color.

public:
 Pen(System::Drawing::Color color);
public Pen (System.Drawing.Color color);
new System.Drawing.Pen : System.Drawing.Color -> System.Drawing.Pen

Parameter

color
Color

Eine Color-Struktur, die die Farbe dieses Pen angibt.A Color structure that indicates the color of this Pen.

Hinweise

Die Color-Eigenschaft wird auf die durch den color-Parameter angegebene Farbe festgelegt.The Color property is set to the color specified by the color parameter. Die Width-Eigenschaft ist auf 1 (Standard) festgelegt.The Width property is set to 1 (the default).

Pen(Brush, Single)

Initialisiert eine neue Instanz der Pen-Klasse mit den angegebenen Brush und dem angegebenen Width.Initializes a new instance of the Pen class with the specified Brush and 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

Parameter

brush
Brush

Ein Brush, der die Merkmale dieses Pen bestimmt.A Brush that determines the characteristics of this Pen.

width
Single

Die Breite des neuen Pen.The width of the new Pen.

Ausnahmen

brush ist null.brush is null.

Beispiele

Im folgenden Codebeispiel wird eine Pen erstellt und die Auswirkungen der Festlegung der Eigenschaften StartCap und EndCap für einen Penveranschaulicht.The following code example creates a Pen and demonstrates the effects of setting the StartCap and EndCap properties on a Pen.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert.This example is designed to be used with Windows Forms. Fügen Sie den Code in ein Formular ein, und nennen Sie die ShowStartAndEndCaps-Methode, wenn Sie das Paint Ereignis des Formulars verarbeiten und e als PaintEventArgsübergeben.Paste the code into a form and call the ShowStartAndEndCaps method when handling the form's Paint event, passing e as 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

Der 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.The Brush is set to the color specified in the brush parameter, the Width property is set to the value specified in the width parameter, and the units are set to World.

Beachten Sie, dass der brush-Parameter auch die Color-Eigenschaft dieses Penangibt.Note that the brush parameter also specifies the Color property of this Pen.

Die width 0 führt dazu, dass die Pen gezeichnet wird, als ob die Breite 1 wäre.A width of 0 will result in the Pen drawing as if the width were 1.

Pen(Color, Single)

Initialisiert eine neue Instanz der Pen-Klasse mit der angegebenen Color-Eigenschaft und der angegebenen Width-Eigenschaft.Initializes a new instance of the Pen class with the specified Color and Width properties.

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

Parameter

color
Color

Eine Color-Struktur, die die Farbe dieses Pen angibt.A Color structure that indicates the color of this Pen.

width
Single

Ein Wert, der die Breite dieses Pen angibt.A value indicating the width of this Pen.

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen einer Pen und die Auswirkungen der Festlegung der Eigenschaften DashCap, DashPatternund SmoothingMode.The following code example demonstrates creating a Pen and the effects of setting the DashCap, DashPattern, and SmoothingMode properties.

Dieses Beispiel ist für die Verwendung mit Windows Forms konzipiert.This example is designed to be used with Windows Forms. Fügen Sie den Code in ein Formular ein, und nennen Sie die ShowPensAndSmoothingMode-Methode, wenn Sie das Paint-Ereignis des Formulars verarbeiten und dabei e als PaintEventArgsübergeben.Paste the code into a form and call the ShowPensAndSmoothingMode method when handling the form's Paint event, passing e as 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 durch den color-Parameter angegebene Farbe festgelegt.The Color property is set to the color specified by the color parameter. Die Width-Eigenschaft wird auf den im Parameter width angegebenen Wert festgelegt.The Width property is set to the value specified in the width parameter. Die width 0 führt dazu, dass die Pen gezeichnet wird, als ob die Breite 1 wäre.A width of 0 will result in the Pen drawing as if the width were 1.

Gilt für: