Graphics::DrawLine Method (Pen^, PointF, PointF)
.NET Framework (current version)
Draws a line connecting two PointF structures.
Assembly: System.Drawing (in System.Drawing.dll)
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
Available since 1.1
Show: