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.

public:
 void DrawLines(System::Drawing::Pen ^ pen, ... cli::array <System::Drawing::Point> ^ points);

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

member this.DrawLines : System.Drawing.Pen * System.Drawing.Point[] -> unit

Public Sub DrawLines (pen As Pen, ParamArray points As Point())

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.

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

      // Create array of points that define lines to draw.
      array<Point>^ points = {Point(10,10),Point(10,100),Point(200,50),Point(250,300)};

      //Draw lines to screen.
      e->Graphics->DrawLines( pen, points );
   }

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

Public Sub DrawLinesPoint(ByVal e As PaintEventArgs)

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

    ' Create array of points that define lines to draw.
    Dim points As Point() = {New Point(10, 10), New Point(10, 100), _
    New Point(200, 50), New Point(250, 300)}

    'Draw lines to screen.
    e.Graphics.DrawLines(blackPen, points)
End Sub

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.

public:
 void DrawLines(System::Drawing::Pen ^ pen, ... cli::array <System::Drawing::PointF> ^ points);

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

member this.DrawLines : System.Drawing.Pen * System.Drawing.PointF[] -> unit

Public Sub DrawLines (pen As Pen, ParamArray points As PointF())

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.

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

      // Create array of points that define lines to draw.
      array<PointF>^ points = {PointF(10.0F,10.0F),PointF(10.0F,100.0F),PointF(200.0F,50.0F),PointF(250.0F,300.0F)};

      //Draw lines to screen.
      e->Graphics->DrawLines( pen, points );
   }

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

Public Sub DrawLinesPointF(ByVal e As PaintEventArgs)

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

    ' Create array of points that define lines to draw.
    Dim points As PointF() = {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(blackPen, points)
End Sub

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.