Pen.StartCap-Eigenschaft

Ruft den Stil für die Enden am Anfang der mit diesem Pen gezeichneten Linien ab oder legt diesen fest.

Namespace: System.Drawing
Assembly: System.Drawing (in system.drawing.dll)

Syntax

'Declaration
Public Property StartCap As LineCap
'Usage
Dim instance As Pen
Dim value As LineCap

value = instance.StartCap

instance.StartCap = value

public LineCap StartCap { get; set; }

public:
property LineCap StartCap {
    LineCap get ();
    void set (LineCap value);
}

/** @property */
public LineCap get_StartCap ()

/** @property */
public void set_StartCap (LineCap value)

public function get StartCap () : LineCap

public function set StartCap (value : LineCap)

Eigenschaftenwert

Einer der LineCap-Werte, der den Stil für die Enden am Anfang der mit diesem Pen gezeichneten Linien darstellt.

Ausnahmen

Ausnahmetyp	Bedingung
InvalidEnumArgumentException	Der angegebene Wert ist kein Member von LineCap.

Beispiel

Im folgenden Codebeispiel werden die Auswirkungen des Festlegens der StartCap-Eigenschaft und der EndCap-Eigenschaft für einen Pen veranschaulicht.

Dieses Beispiel ist für die Verwendung mit Windows Forms vorgesehen. Fügen Sie den Code in ein Formular ein, und rufen Sie beim Behandeln des Paint-Ereignisses des Formulars die ShowStartAndEndCaps-Methode auf, wobei Sie e als PaintEventArgs übergeben.

Private Sub ShowStartAndEndCaps(ByVal e As PaintEventArgs)

    ' Create a new custom pen.
    Dim redPen As New Pen(Brushes.Red, 6.0F)

    ' Set the StartCap property.
    redPen.StartCap = Drawing2D.LineCap.RoundAnchor

    ' Set the EndCap property.
    redPen.EndCap = Drawing2D.LineCap.ArrowAnchor

    ' Draw a line.
    e.Graphics.DrawLine(redPen, 40.0F, 40.0F, 145.0F, 185.0F)

    ' Dispose of the custom pen.
    redPen.Dispose()

End Sub

private void ShowStartAndEndCaps(PaintEventArgs e)
{

    // Create a new custom pen.
    Pen redPen = new Pen(Brushes.Red, 6.0F);

    // Set the StartCap property.
    redPen.StartCap = System.Drawing.Drawing2D.LineCap.RoundAnchor;

    // Set the EndCap property.
    redPen.EndCap = System.Drawing.Drawing2D.LineCap.ArrowAnchor;

    // Draw a line.
    e.Graphics.DrawLine(redPen, 40.0F, 40.0F, 145.0F, 185.0F);

    // Dispose of the custom pen.
    redPen.Dispose();

}

private:
   void ShowStartAndEndCaps( PaintEventArgs^ e )
   {
      // Create a new custom pen.
      Pen^ redPen = gcnew Pen( Brushes::Red,6.0F );

      // Set the StartCap property.
      redPen->StartCap = System::Drawing::Drawing2D::LineCap::RoundAnchor;

      // Set the EndCap property.
      redPen->EndCap = System::Drawing::Drawing2D::LineCap::ArrowAnchor;

      // Draw a line.
      e->Graphics->DrawLine( redPen, 40.0F, 40.0F, 145.0F, 185.0F );

      // Dispose of the custom pen.
      delete redPen;
   }

private void ShowStartAndEndCaps(PaintEventArgs e)
{
    // Create a new custom pen.
    Pen redPen = new Pen(Brushes.get_Red(), 6);

    // Set the StartCap property.
    redPen.set_StartCap(System.Drawing.Drawing2D.LineCap.RoundAnchor);

    // Set the EndCap property.
    redPen.set_EndCap(System.Drawing.Drawing2D.LineCap.ArrowAnchor);

    // Draw a line.
    e.get_Graphics().DrawLine(redPen, 40, 40, 145, 185);

    // Dispose of the custom pen.
    redPen.Dispose();
} //ShowStartAndEndCaps

Plattformen

Windows 98, Windows 2000 SP4, Windows CE, Windows Millennium Edition, Windows Mobile für Pocket PC, Windows Mobile für Smartphone, Windows Server 2003, Windows XP Media Center Edition, Windows XP Professional x64 Edition, Windows XP SP2, Windows XP Starter Edition

.NET Framework unterstützt nicht alle Versionen sämtlicher Plattformen. Eine Liste der unterstützten Versionen finden Sie unter Systemanforderungen.

Versionsinformationen

.NET Framework

Unterstützt in: 2.0, 1.1, 1.0

Siehe auch

Referenz

Pen-Klasse
Pen-Member
System.Drawing-Namespace