Pen.SetLineCap(LineCap, LineCap, DashCap) Method

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Package:

System.Drawing.Common v8.0.0

Source:

Pen.cs

Sets the values that determine the style of cap used to end lines drawn by this Pen.

public:
 void SetLineCap(System::Drawing::Drawing2D::LineCap startCap, System::Drawing::Drawing2D::LineCap endCap, System::Drawing::Drawing2D::DashCap dashCap);

public void SetLineCap (System.Drawing.Drawing2D.LineCap startCap, System.Drawing.Drawing2D.LineCap endCap, System.Drawing.Drawing2D.DashCap dashCap);

member this.SetLineCap : System.Drawing.Drawing2D.LineCap * System.Drawing.Drawing2D.LineCap * System.Drawing.Drawing2D.DashCap -> unit

Public Sub SetLineCap (startCap As LineCap, endCap As LineCap, dashCap As DashCap)

Parameters

startCap

LineCap

A LineCap that represents the cap style to use at the beginning of lines drawn with this Pen.

endCap

LineCap

A LineCap that represents the cap style to use at the end of lines drawn with this Pen.

dashCap

DashCap

A LineCap that represents the cap style to use at the beginning or end of dashed lines drawn with this Pen.

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code creates a Pen and sets it to draw arrow anchor caps at the beginning of lines:

public:
   void SetLineCap_Example( PaintEventArgs^ e )
   {
      
      // Create a Pen object with a dash pattern.
      Pen^ capPen = gcnew Pen( Color::Black,5.0f );
      capPen->DashStyle = DashStyle::Dash;
      
      // Set the start and end caps for capPen.
      capPen->SetLineCap( LineCap::ArrowAnchor, LineCap::Flat, DashCap::Flat );
      
      // Draw a line with capPen.
      e->Graphics->DrawLine( capPen, 10, 10, 200, 10 );
   }

public void SetLineCap_Example(PaintEventArgs e)
{
             
    // Create a Pen object with a dash pattern.
    Pen capPen = new Pen(Color.Black, 5);
    capPen.DashStyle = DashStyle.Dash;
             
    // Set the start and end caps for capPen.
    capPen.SetLineCap(LineCap.ArrowAnchor, LineCap.Flat, DashCap.Flat);
             
    // Draw a line with capPen.
    e.Graphics.DrawLine(capPen, 10, 10, 200, 10);
}

Public Sub SetLineCap_Example(ByVal e As PaintEventArgs)

    ' Create a Pen object with a dash pattern.
    Dim capPen As New Pen(Color.Black, 5)
    capPen.DashStyle = DashStyle.Dash

    ' Set the start and end caps for capPen.
    capPen.SetLineCap(LineCap.ArrowAnchor, LineCap.Flat, DashCap.Flat)

    ' Draw a line with capPen.
    e.Graphics.DrawLine(capPen, 10, 10, 200, 10)
End Sub