Graphics.DrawLine Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v8.0.0

Desenha uma linha que conecta os dois pontos especificados por pares de coordenadas.

Sobrecargas

DrawLine(Pen, Int32, Int32, Int32, Int32)	Desenha uma linha que conecta os dois pontos especificados por pares de coordenadas.
DrawLine(Pen, Single, Single, Single, Single)	Desenha uma linha que conecta os dois pontos especificados por pares de coordenadas.
DrawLine(Pen, Point, Point)	Desenha uma linha conectando duas estruturas Point.
DrawLine(Pen, PointF, PointF)	Desenha uma linha conectando duas estruturas PointF.

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

Origem:

Graphics.cs

Desenha uma linha que conecta os dois pontos especificados por pares de coordenadas.

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)

Parâmetros

pen

Pen

Pen que determina a cor, a largura e o estilo da linha.

x1

Int32

A coordenada X do primeiro ponto.

y1

Int32

A coordenada y do primeiro ponto.

x2

Int32

A coordenada X do segundo ponto.

y2

Int32

A coordenada y do segundo ponto.

Exceções

ArgumentNullException

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

• Cria uma caneta preta.

• Cria as coordenadas dos pontos de extremidade da linha.

• Desenha a linha para a tela.

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

Comentários

Esse método desenha uma linha que conecta os dois pontos especificados pelos x1parâmetros , y1, x2e y2 .

Confira também

• Uso de uma caneta para desenhar linhas e formas

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

Origem:

Graphics.cs

Desenha uma linha que conecta os dois pontos especificados por pares de coordenadas.

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)

Parâmetros

pen

Pen

Pen que determina a cor, a largura e o estilo da linha.

x1

Single

A coordenada X do primeiro ponto.

y1

Single

A coordenada y do primeiro ponto.

x2

Single

A coordenada X do segundo ponto.

y2

Single

A coordenada y do segundo ponto.

Exceções

ArgumentNullException

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

• Cria uma caneta preta.

• Cria as coordenadas dos pontos de extremidade da linha.

• Desenha a linha para a tela.

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

Comentários

Esse método desenha uma linha que conecta os dois pontos especificados pelos x1parâmetros , y1, x2e y2 .

Confira também

• Uso de uma caneta para desenhar linhas e formas

DrawLine(Pen, Point, Point)

Origem:

Graphics.cs

Desenha uma linha conectando duas estruturas 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)

Parâmetros

pen

Pen

Pen que determina a cor, a largura e o estilo da linha.

pt1

Point

Estrutura Point que representa o primeiro ponto de conexão.

pt2

Point

Estrutura Point que representa o segundo ponto de conexão.

Exceções

ArgumentNullException

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

• Cria uma caneta preta.

• Cria pontos para os pontos de extremidade da linha.

• Desenha a linha para a tela.

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

Confira também

• Uso de uma caneta para desenhar linhas e formas

DrawLine(Pen, PointF, PointF)

Origem:

Graphics.cs

Desenha uma linha conectando duas estruturas 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)

Parâmetros

pen

Pen

Pen que determina a cor, a largura e o estilo da linha.

pt1

PointF

Estrutura PointF que representa o primeiro ponto de conexão.

pt2

PointF

Estrutura PointF que representa o segundo ponto de conexão.

Exceções

ArgumentNullException

pen é null.

Exemplos

O exemplo de código a seguir foi projetado para uso com Windows Forms e requer PaintEventArgse, que é um parâmetro do Paint manipulador de eventos. O código executa as seguintes ações:

• Cria uma caneta preta.

• Cria pontos para os pontos de extremidade da linha.

• Desenha a linha para a tela.

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

Comentários

Esse método desenha uma linha que conecta os dois pontos especificados pelos pt1 parâmetros e p2 .

Confira também

• Uso de uma caneta para desenhar linhas e formas