Graphics.DrawLines Método

Definição

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacote:

System.Drawing.Common v9.0.0-preview.7.24405.4

Desenha uma série de segmentos de linha que conectam uma matriz de estruturas Point.

Sobrecargas

DrawLines(Pen, Point[])	Desenha uma série de segmentos de linha que conectam uma matriz de estruturas Point.
DrawLines(Pen, PointF[])	Desenha uma série de segmentos de linha que conectam uma matriz de estruturas PointF.

DrawLines(Pen, Point[])

Origem:

Graphics.cs

Desenha uma série de segmentos de linha que conectam uma matriz de estruturas Point.

C#

public void DrawLines (System.Drawing.Pen pen, params System.Drawing.Point[] points);

Parâmetros

pen

Pen

Pen que determina a cor, a largura e o estilo dos segmentos de linha.

points

Point[]

Matriz de estruturas Point que representam os pontos a serem conectados.

Exceções

ArgumentNullException

pen é null.

-ou-

points é null.

Exemplos

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

• Cria uma caneta preta.

• Cria uma matriz de pontos de segmentos da linha.

• Desenha os segmentos de linha conectados à tela.

C#

public void DrawLinesPoint(PaintEventArgs e)
{
             
    // Create pen.
    Pen pen = new Pen(Color.Black, 3);
             
    // Create array of points that define lines to draw.
    Point[] points =
             {
                 new Point(10,  10),
                 new Point(10, 100),
                 new Point(200,  50),
                 new Point(250, 300)
             };
             
    //Draw lines to screen.
    e.Graphics.DrawLines(pen, points);
}

Comentários

Esse método desenha uma série de linhas que conectam uma matriz de pontos finais. Os dois primeiros pontos na matriz especificam a primeira linha. Cada ponto adicional especifica o final de um segmento de linha cujo ponto de partida é o ponto final do segmento de linha anterior.

DrawLines(Pen, PointF[])

Origem:

Graphics.cs

Desenha uma série de segmentos de linha que conectam uma matriz de estruturas PointF.

C#

public void DrawLines (System.Drawing.Pen pen, params System.Drawing.PointF[] points);

Parâmetros

pen

Pen

Pen que determina a cor, a largura e o estilo dos segmentos de linha.

points

PointF[]

Matriz de estruturas PointF que representam os pontos a serem conectados.

Exceções

ArgumentNullException

pen é null.

-ou-

points é null.

Exemplos

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

• O código cria uma caneta preta.

• Cria uma matriz de pontos de segmentos da linha.

• Desenha os segmentos de linha conectados à tela.

C#

public void DrawLinesPointF(PaintEventArgs e)
{
             
    // Create pen.
    Pen pen = new Pen(Color.Black, 3);
             
    // Create array of points that define lines to draw.
    PointF[] points =
             {
                 new PointF(10.0F,  10.0F),
                 new PointF(10.0F, 100.0F),
                 new PointF(200.0F,  50.0F),
                 new PointF(250.0F, 300.0F)
             };
             
    //Draw lines to screen.
    e.Graphics.DrawLines(pen, points);
}

Comentários

Esse método desenha uma série de linhas que conectam uma matriz de pontos finais. Os dois primeiros pontos na matriz especificam a primeira linha. Cada ponto adicional especifica o final de um segmento de linha cujo ponto de partida é o ponto final do segmento de linha anterior.