Pen::StartCap Property

 

Gets or sets the cap style used at the beginning of lines drawn with this Pen.

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

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

Property Value

Type: System.Drawing.Drawing2D::LineCap

One of the LineCap values that represents the cap style used at the beginning of lines drawn with this Pen.

Exception Condition
InvalidEnumArgumentException

The specified value is not a member of LineCap.

ArgumentException

The StartCap property is set on an immutable Pen, such as those returned by the Pens class.

The following code example demonstrates the effects of setting the StartCap and EndCap properties on a Pen.

This example is designed to be used with Windows Forms. Paste the code into a form and call the ShowStartAndEndCaps method when handling the form's Paint event, passing e as PaintEventArgs.

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;
   }

.NET Framework
Available since 1.1
Return to top
Show: