Export (0) Print
Expand All

Graphics.DrawLine Method (Pen, Single, Single, Single, Single)

.NET Framework 1.1

Draws a line connecting the two points specified by coordinate pairs.

[Visual Basic]
Overloads Public Sub DrawLine( _
   ByVal pen As Pen, _
   ByVal x1 As Single, _
   ByVal y1 As Single, _
   ByVal x2 As Single, _
   ByVal y2 As Single _
)
[C#]
public void DrawLine(
 Pen pen,
 float x1,
 float y1,
 float x2,
 float y2
);
[C++]
public: void DrawLine(
 Pen* pen,
 float x1,
 float y1,
 float x2,
 float y2
);
[JScript]
public function DrawLine(
   pen : Pen,
 x1 : float,
 y1 : float,
 x2 : float,
 y2 : float
);

Parameters

pen
Pen object that determines the color, width, and style of the line.
x1
x-coordinate of the first point.
y1
y-coordinate of the first point.
x2
x-coordinate of the second point.
y2
y-coordinate of the second point.

Return Value

This method does not return a value.

Remarks

This method draws a line connecting the two points specified by the x1, y1, x2, and y2 parameters.

Example

[Visual Basic, C#] The following example is designed for use with Windows Forms, and it requires PaintEventArgs e, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a black pen.
  • Creates the coordinates of the endpoints of the line.
  • Draws the line to the screen.
[Visual Basic] 
Public Sub DrawLineFloat(e As PaintEventArgs)
' Create pen.
Dim blackPen As New Pen(Color.Black, 3)
' Create coordinates of points that define line.
Dim x1 As Single = 100F
Dim y1 As Single = 100F
Dim x2 As Single = 500F
Dim y2 As Single = 100F
' Draw line to screen.
e.Graphics.DrawLine(blackPen, x1, y1, x2, y2)
End Sub
        
[C#] 
public void DrawLineFloat(PaintEventArgs e)
{
// Create pen.
Pen blackPen = new Pen(Color.Black, 3);
// Create coordinates of points that define line.
float x1 = 100.0F;
float y1 = 100.0F;
float x2 = 500.0F;
float y2 = 100.0F;
// Draw line to screen.
e.Graphics.DrawLine(blackPen, x1, y1, x2, y2);
}
        

[C++, JScript] No example is available for C++ or JScript. To view a Visual Basic or C# example, click the Language Filter button Language Filter in the upper-left corner of the page.

Requirements

Platforms: Windows 98, Windows NT 4.0, Windows Millennium Edition, Windows 2000, Windows XP Home Edition, Windows XP Professional, Windows Server 2003 family

See Also

Graphics Class | Graphics Members | System.Drawing Namespace | Graphics.DrawLine Overload List

Show:
© 2015 Microsoft