Pen.StartCap Property
Definition
Important
Some information relates to prerelease product that may be substantially modified before it’s released. Microsoft makes no warranties, express or implied, with respect to the information provided here.
Gets or sets the cap style used at the beginning of lines drawn with this Pen.
public:
property System::Drawing::Drawing2D::LineCap StartCap { System::Drawing::Drawing2D::LineCap get(); void set(System::Drawing::Drawing2D::LineCap value); };
public System.Drawing.Drawing2D.LineCap StartCap { get; set; }
member this.StartCap : System.Drawing.Drawing2D.LineCap with get, set
Public Property StartCap As LineCap
Property Value
One of the LineCap values that represents the cap style used at the beginning of lines drawn with this Pen.
Exceptions
The specified value is not a member of LineCap.
Examples
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;
}
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 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