Pen.Width Eigenschaft

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

System.Drawing.Common v8.0.0

Quelle:

Pen.cs

Ruft die Breite dieses Pen in Einheiten des zum Zeichnen verwendeten Graphics-Objekts ab oder legt diese fest.

public:
 property float Width { float get(); void set(float value); };

public float Width { get; set; }

member this.Width : single with get, set

Public Property Width As Single

Eigenschaftswert

Single

Die Breite dieses Pen.

Ausnahmen

ArgumentException

Die Width-Eigenschaft wird auf einen unveränderlichen Pen festgelegt, der z. B. von der Pens-Klasse zurückgegeben wird.

Beispiele

Im folgenden Codebeispiel werden die Auswirkungen des Festlegens der Width Eigenschaften und LineJoin auf eine 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

Sie können mithilfe PageUnit der -Eigenschaft auf die Maßeinheit des Graphics Objekts zugreifen. Die Maßeinheit ist in der Regel Pixel. Eine Width von 0 führt zur Pen Zeichnung, als wäre die Width 1.