This documentation is archived and is not being maintained.

Pen.LineJoin Property

Gets or sets the join style for the ends of two consecutive lines drawn with this Pen.

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

public LineJoin LineJoin { get; set; }

Property Value

Type: System.Drawing.Drawing2D.LineJoin
A LineJoin that represents the join style for the ends of two consecutive lines drawn with this Pen.

ExceptionCondition
ArgumentException

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

A line join is the common area that is formed by two lines whose ends meet or overlap. There are three line join styles: miter, bevel, and round. When you specify a line join style for a Pen object, that join style will be applied to all the connected lines in any GraphicsPath object drawn using that pen.The following illustration shows the results of the beveled line join example.

Pens

The following code example demonstrates the effects of setting the Width and LineJoin properties on a Pen.

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


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();

}


.NET Framework

Supported in: 4, 3.5, 3.0, 2.0, 1.1, 1.0

.NET Framework Client Profile

Supported in: 4, 3.5 SP1

Windows 7, Windows Vista SP1 or later, Windows XP SP3, Windows XP SP2 x64 Edition, Windows Server 2008 (Server Core not supported), Windows Server 2008 R2 (Server Core supported with SP1 or later), Windows Server 2003 SP2

The .NET Framework does not support all versions of every platform. For a list of the supported versions, see .NET Framework System Requirements.
Show: