Graphics.DrawLine Method (Pen, PointF, PointF)

 

Draws a line connecting two PointF structures.

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

public void DrawLine(
	Pen pen,
	PointF pt1,
	PointF pt2
)

Parameters

pen
Type: System.Drawing.Pen

Pen that determines the color, width, and style of the line.

pt1
Type: System.Drawing.PointF

PointF structure that represents the first point to connect.

pt2
Type: System.Drawing.PointF

PointF structure that represents the second point to connect.

Exception Condition
ArgumentNullException

pen is null.

This method draws a line connecting the two points specified by the pt1 and p2 parameters.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a black pen.

  • Creates points for the endpoints of the line.

  • Draws the line to the screen.

public void DrawLinePointF(PaintEventArgs e)
{

    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);

    // Create points that define line.
    PointF point1 = new PointF(100.0F, 100.0F);
    PointF point2 = new PointF(500.0F, 100.0F);

    // Draw line to screen.
    e.Graphics.DrawLine(blackPen, point1, point2);
}

.NET Framework
Available since 1.1
Return to top
Show: