This documentation is archived and is not being maintained.

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

.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 Integer, _
   ByVal y1 As Integer, _
   ByVal x2 As Integer, _
   ByVal y2 As Integer _
)
[C#]
public void DrawLine(
 Pen pen,
 int x1,
 int y1,
 int x2,
 int y2
);
[C++]
public: void DrawLine(
 Pen* pen,
 int x1,
 int y1,
 int x2,
 int y2
);
[JScript]
public function DrawLine(
   pen : Pen,
 x1 : int,
 y1 : int,
 x2 : int,
 y2 : int
);

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 DrawLineInt(e As PaintEventArgs)
' Create pen.
Dim blackPen As New Pen(Color.Black, 3)
' Create coordinates of points that define line.
Dim x1 As Integer = 100
Dim y1 As Integer = 100
Dim x2 As Integer = 500
Dim y2 As Integer = 100
' Draw line to screen.
e.Graphics.DrawLine(blackPen, x1, y1, x2, y2)
End Sub
        
[C#] 
public void DrawLineInt(PaintEventArgs e)
{
// Create pen.
Pen blackPen = new Pen(Color.Black, 3);
// Create coordinates of points that define line.
int x1 = 100;
int y1 = 100;
int x2 = 500;
int y2 = 100;
// 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, .NET Compact Framework

See Also

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

Show: