This documentation is archived and is not being maintained.

Pen Constructor (Color, Single)

Initializes a new instance of the Pen class with the specified Color and Width properties.

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

public Pen(
	Color color,
	float width


Type: System.Drawing.Color
A Color structure that indicates the color of this Pen.
Type: System.Single
A value indicating the width of this Pen.

The Color property is set to the color specified by the color parameter. The Width property is set to the value specified in the width parameter. A width of 0 will result in the Pen drawing as if the width were 1.

The following code example demonstrates creating a Pen and the effects of setting the DashCap, DashPattern, and SmoothingMode properties.

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

private void ShowPensAndSmoothingMode(PaintEventArgs e)

    // Set the SmoothingMode property to smooth the line.
    e.Graphics.SmoothingMode = 

    // Create a new Pen object.
    Pen greenPen = new Pen(Color.Green);

    // Set the width to 6.
    greenPen.Width = 6.0F;

    // Set the DashCap to round.
    greenPen.DashCap = System.Drawing.Drawing2D.DashCap.Round;

    // Create a custom dash pattern.
    greenPen.DashPattern = new float[]{4.0F, 2.0F, 1.0F, 3.0F};

    // Draw a line.
    e.Graphics.DrawLine(greenPen, 20.0F, 20.0F, 100.0F, 240.0F);

    // Change the SmoothingMode to none.
    e.Graphics.SmoothingMode = 

    // Draw another line.
    e.Graphics.DrawLine(greenPen, 100.0F, 240.0F, 160.0F, 20.0F);

    // Dispose of the custom pen.

.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.