Pen Konstruktoren

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

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

Überlädt

Name	Beschreibung
Pen(Brush)	Initialisiert eine neue Instanz der Pen Klasse mit dem 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 dem angegebenen Brush und Width.
Pen(Color, Single)	Initialisiert eine neue Instanz der Pen Klasse mit den angegebenen Color Und Width Eigenschaften.

Pen(Brush)

Quelle:

Pen.cs

Initialisiert eine neue Instanz der Pen Klasse mit dem 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 Element, das die Fülleigenschaften dieser PenEigenschaft bestimmt.

Ausnahmen

ArgumentNullException

brush ist null.

Beispiele

Das folgende Codebeispiel veranschaulicht das Erstellen einer Pen mit einer Brush und der Auswirkungen der Festlegung der LineJoin Eigenschaft auf ein Pen.

Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Fügen Sie den Code in ein Formular ein, und rufen Sie die ShowLineJoin Methode beim Behandeln des Formularereignisses Paint auf und übergeben als ePaintEventArgs.

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 die Pen Linien zeichnungen. Linien werden so gezeichnet, als wären sie gefüllte Rechtecke mit den Merkmalen der angegebenen Brush.

Die Width Eigenschaft des neuen Pen ist auf 1 (Standardeinstellung) 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 Werts Penangibt.

Hinweise

Die Color Eigenschaft wird auf die durch den color Parameter angegebene Farbe festgelegt. Die Width Eigenschaft ist auf 1 (Standardeinstellung) festgelegt.

Pen(Brush, Single)

Quelle:

Pen.cs

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

width

Single

Die Breite des neuen Pen.

Ausnahmen

ArgumentNullException

brush ist null.

Beispiele

Das folgende Codebeispiel erstellt und Pen veranschaulicht die Auswirkungen des Festlegens der StartCap Und EndCap Eigenschaften für ein Pen.

Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Fügen Sie den Code in ein Formular ein, und rufen Sie die ShowStartAndEndCaps Methode beim Behandeln des Formularereignisses Paint auf und übergeben als ePaintEventArgs.

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 Wert 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 World.

Beachten Sie, dass der brush Parameter auch die Color Eigenschaft dieses PenWerts angibt.

Wenn dieser Wert 0 ist, beträgt die Breite in Geräteeinheiten immer 1 Pixel. Sie ist nicht von Skalierungstransformationsvorgängen betroffen, die für das Grafikobjekt wirksam sind, für das das Pen verwendete Grafikobjekt verwendet wird.

Pen(Color, Single)

Quelle:

Pen.cs

Initialisiert eine neue Instanz der Pen Klasse mit den angegebenen Color Und Width Eigenschaften.

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 Werts Penangibt.

width

Single

Ein Wert, der die Breite dieses Werts Penangibt.

Beispiele

Im folgenden Codebeispiel wird das Erstellen einer Pen und der Effekte des Festlegens der DashCapEigenschaften und SmoothingMode der Eigenschaften DashPatternveranschaulicht.

Dieses Beispiel wurde für die Verwendung mit Windows Forms entwickelt. Fügen Sie den Code in ein Formular ein, und rufen Sie die ShowPensAndSmoothingMode Methode beim Behandeln des Formularereignisses Paint auf, 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 durch den 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 ist nicht von Skalierungstransformationsvorgängen betroffen, die für das Grafikobjekt wirksam sind, für das das Pen verwendete Grafikobjekt verwendet wird.