Graphics.DrawLine 方法

定義

命名空間:

System.Drawing

組件:

System.Drawing.Common.dll

套件:

System.Drawing.Common v8.0.0

繪製連接由座標對所指定的兩個點之直線。

多載

DrawLine(Pen, Int32, Int32, Int32, Int32)	繪製連接由座標對所指定的兩個點之直線。
DrawLine(Pen, Single, Single, Single, Single)	繪製連接由座標對所指定的兩個點之直線。
DrawLine(Pen, Point, Point)	繪製連接兩個 Point 結構的直線。
DrawLine(Pen, PointF, PointF)	繪製連接兩個 PointF 結構的直線。

DrawLine(Pen, Int32, Int32, Int32, Int32)

來源:

Graphics.cs

繪製連接由座標對所指定的兩個點之直線。

public:
 void DrawLine(System::Drawing::Pen ^ pen, int x1, int y1, int x2, int y2);

public void DrawLine (System.Drawing.Pen pen, int x1, int y1, int x2, int y2);

member this.DrawLine : System.Drawing.Pen * int * int * int * int -> unit

Public Sub DrawLine (pen As Pen, x1 As Integer, y1 As Integer, x2 As Integer, y2 As Integer)

參數

pen

Pen

Pen，決定直線的色彩、寬度和樣式。

x1

Int32

第一點的 X 座標。

y1

Int32

第一點的 Y 座標。

x2

Int32

第二點的 X 座標。

y2

Int32

第二點的 Y 座標。

例外狀況

ArgumentNullException

pen 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。 此程式碼會執行下列動作：

• 建立黑色畫筆。

• 建立線條端點的座標。

• 將線條繪製到畫面。

public:
   void DrawLineInt( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // 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 );
   }

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);
}

Public Sub DrawLineInt(ByVal 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

備註

這個方法會繪製連接 、y1、 x2和 y2 參數所指定兩個點的x1線條。

另請參閱

• 使用畫筆繪製線條和形狀

DrawLine(Pen, Single, Single, Single, Single)

來源:

Graphics.cs

繪製連接由座標對所指定的兩個點之直線。

public:
 void DrawLine(System::Drawing::Pen ^ pen, float x1, float y1, float x2, float y2);

public void DrawLine (System.Drawing.Pen pen, float x1, float y1, float x2, float y2);

member this.DrawLine : System.Drawing.Pen * single * single * single * single -> unit

Public Sub DrawLine (pen As Pen, x1 As Single, y1 As Single, x2 As Single, y2 As Single)

參數

pen

Pen

Pen，決定直線的色彩、寬度和樣式。

x1

Single

第一點的 X 座標。

y1

Single

第一點的 Y 座標。

x2

Single

第二點的 X 座標。

y2

Single

第二點的 Y 座標。

例外狀況

ArgumentNullException

pen 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。 此程式碼會執行下列動作：

• 建立黑色畫筆。

• 建立線條端點的座標。

• 將線條繪製到畫面。

public:
   void DrawLineFloat( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // 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 );
   }

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);
}

Public Sub DrawLineFloat(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create coordinates of points that define line.
    Dim x1 As Single = 100.0F
    Dim y1 As Single = 100.0F
    Dim x2 As Single = 500.0F
    Dim y2 As Single = 100.0F

    ' Draw line to screen.
    e.Graphics.DrawLine(blackPen, x1, y1, x2, y2)
End Sub

備註

這個方法會繪製連接 、y1、 x2和 y2 參數所指定兩個點的x1線條。

另請參閱

• 使用畫筆繪製線條和形狀

DrawLine(Pen, Point, Point)

來源:

Graphics.cs

繪製連接兩個 Point 結構的直線。

public:
 void DrawLine(System::Drawing::Pen ^ pen, System::Drawing::Point pt1, System::Drawing::Point pt2);

public void DrawLine (System.Drawing.Pen pen, System.Drawing.Point pt1, System.Drawing.Point pt2);

member this.DrawLine : System.Drawing.Pen * System.Drawing.Point * System.Drawing.Point -> unit

Public Sub DrawLine (pen As Pen, pt1 As Point, pt2 As Point)

參數

pen

Pen

Pen，決定直線的色彩、寬度和樣式。

pt1

Point

Point 結構，表示要連接的第一個點。

pt2

Point

Point 結構，表示要連接的第二個點。

例外狀況

ArgumentNullException

pen 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。 此程式碼會執行下列動作：

• 建立黑色畫筆。

• 建立線條端點的點。

• 將線條繪製到畫面。

public:
   void DrawLinePoint( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create points that define line.
      Point point1 = Point(100,100);
      Point point2 = Point(500,100);

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

public void DrawLinePoint(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create points that define line.
    Point point1 = new Point(100, 100);
    Point point2 = new Point(500, 100);
             
    // Draw line to screen.
    e.Graphics.DrawLine(blackPen, point1, point2);
}

Public Sub DrawLinePoint(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create points that define line.
    Dim point1 As New Point(100, 100)
    Dim point2 As New Point(500, 100)

    ' Draw line to screen.
    e.Graphics.DrawLine(blackPen, point1, point2)
End Sub

另請參閱

• 使用畫筆繪製線條和形狀

DrawLine(Pen, PointF, PointF)

來源:

Graphics.cs

繪製連接兩個 PointF 結構的直線。

public:
 void DrawLine(System::Drawing::Pen ^ pen, System::Drawing::PointF pt1, System::Drawing::PointF pt2);

public void DrawLine (System.Drawing.Pen pen, System.Drawing.PointF pt1, System.Drawing.PointF pt2);

member this.DrawLine : System.Drawing.Pen * System.Drawing.PointF * System.Drawing.PointF -> unit

Public Sub DrawLine (pen As Pen, pt1 As PointF, pt2 As PointF)

參數

pen

Pen

Pen，決定直線的色彩、寬度和樣式。

pt1

PointF

PointF 結構，表示要連接的第一個點。

pt2

PointF

PointF 結構，表示要連接的第二個點。

例外狀況

ArgumentNullException

pen 為 null。

範例

下列程式代碼範例是設計來搭配 Windows Forms 使用，而且需要 PaintEventArgse，這是事件處理程序的參數Paint。 此程式碼會執行下列動作：

• 建立黑色畫筆。

• 建立線條端點的點。

• 將線條繪製到畫面。

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 );
   }

public void DrawLinePointF(PaintEventArgs e)
{
             
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create points that define line.
    PointF point1 = new PointF(100.0F, 100.0F);
    PointF point2 = new PointF(500.0F, 100.0F);
             
    // Draw line to screen.
    e.Graphics.DrawLine(blackPen, point1, point2);
}

Public Sub DrawLinePointF(ByVal e As PaintEventArgs)

    ' Create pen.
    Dim blackPen As New Pen(Color.Black, 3)

    ' Create points that define line.
    Dim point1 As New PointF(100.0F, 100.0F)
    Dim point2 As New PointF(500.0F, 100.0F)

    ' Draw line to screen.
    e.Graphics.DrawLine(blackPen, point1, point2)
End Sub

備註

這個方法會繪製連接 和 p2 參數所指定兩個點的pt1線條。

另請參閱

• 使用畫筆繪製線條和形狀