Graphics.DrawLines Método

Definición

Espacio de nombres:

System.Drawing

Ensamblado:

System.Drawing.Common.dll

Paquete:

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

Dibuja una serie de segmentos de línea que conectan una matriz de estructuras de Point.

Sobrecargas

DrawLines(Pen, Point[])	Dibuja una serie de segmentos de línea que conectan una matriz de estructuras de Point.
DrawLines(Pen, PointF[])	Dibuja una serie de segmentos de línea que conectan una matriz de estructuras de PointF.

DrawLines(Pen, Point[])

Source:

Graphics.cs

Dibuja una serie de segmentos de línea que conectan una matriz de estructuras de Point.

C#

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

Parámetros

pen

Pen

Pen que determina el color, el ancho y el estilo de los segmentos de línea.

points

Point[]

Matriz de Point estructuras que representan los puntos que se van a conectar.

Excepciones

ArgumentNullException

pen es null.

-o-

points es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

• Crea un lápiz negro.

• Crea una matriz de puntos de segmentos de la línea.

• Dibuja los segmentos de línea conectados en la pantalla.

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

Comentarios

Este método dibuja una serie de líneas que conectan una matriz de puntos finales. Los dos primeros puntos de la matriz especifican la primera línea. Cada punto adicional especifica el final de un segmento de línea cuyo punto inicial es el punto final del segmento de línea anterior.

DrawLines(Pen, PointF[])

Source:

Graphics.cs

Dibuja una serie de segmentos de línea que conectan una matriz de estructuras de PointF.

C#

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

Parámetros

pen

Pen

Pen que determina el color, el ancho y el estilo de los segmentos de línea.

points

PointF[]

Matriz de PointF estructuras que representan los puntos que se van a conectar.

Excepciones

ArgumentNullException

pen es null.

-o-

points es null.

Ejemplos

El ejemplo de código siguiente está diseñado para su uso con Windows Forms y requiere PaintEventArgse, que es un parámetro del controlador de eventos Paint. El código realiza las siguientes acciones:

• El código crea un lápiz negro.

• Crea una matriz de puntos de segmentos de la línea.

• Dibuja los segmentos de línea conectados en la pantalla.

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

Comentarios

Este método dibuja una serie de líneas que conectan una matriz de puntos finales. Los dos primeros puntos de la matriz especifican la primera línea. Cada punto adicional especifica el final de un segmento de línea cuyo punto inicial es el punto final del segmento de línea anterior.