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 = 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
Show: