Graphics::DrawLine Method (Pen^, PointF, PointF)


Draws a line connecting two PointF structures.

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

void DrawLine(
	Pen^ pen,
	PointF pt1,
	PointF pt2


Type: System.Drawing::Pen^

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

Type: System.Drawing::PointF

PointF structure that represents the first point to connect.

Type: System.Drawing::PointF

PointF structure that represents the second point to connect.

Exception Condition

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.

   void DrawLinePointF( PaintEventArgs^ e )

      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

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

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

.NET Framework
Available since 1.1
Return to top