Graphics.DrawBeziers 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 splines bézier de una matriz de estructuras Point.

Sobrecargas

DrawBeziers(Pen, Point[])	Dibuja una serie de splines bézier de una matriz de estructuras Point.
DrawBeziers(Pen, PointF[])	Dibuja una serie de splines bézier de una matriz de estructuras PointF.

DrawBeziers(Pen, Point[])

Source:

Graphics.cs

Dibuja una serie de splines bézier de una matriz de estructuras Point.

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

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

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

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

Parámetros

pen

Pen

Pen que determina el color, el ancho y el estilo de la curva.

points

Point[]

Matriz de Point estructuras que representan los puntos que determinan la curva. El número de puntos de la matriz debe ser un múltiplo de 3 más 1, como 4, 7 o 10.

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 los puntos de control inicial, final y dos para una primera curva y un punto de conexión y dos puntos de control para una segunda curva.

• Dibuja las sucesivas curvas bézier en la pantalla.

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

      // Create points for curve.
      Point start = Point(100,100);
      Point control1 = Point(200,10);
      Point control2 = Point(350,50);
      Point end1 = Point(500,100);
      Point control3 = Point(600,150);
      Point control4 = Point(650,250);
      Point end2 = Point(500,300);
      array<Point>^ bezierPoints = {start,control1,control2,end1,control3,control4,end2};

      // Draw arc to screen.
      e->Graphics->DrawBeziers( blackPen, bezierPoints );
   }

private void DrawBeziersPoint(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create points for curve.
    Point start = new Point(100, 100);
    Point control1 = new Point(200, 10);
    Point control2 = new Point(350, 50);
    Point end1 = new Point(500, 100);
    Point control3 = new Point(600, 150);
    Point control4 = new Point(650, 250);
    Point end2 = new Point(500, 300);
    Point[] bezierPoints =
             {
                 start, control1, control2, end1,
                 control3, control4, end2
             };
             
    // Draw arc to screen.
    e.Graphics.DrawBeziers(blackPen, bezierPoints);
}

Private Sub DrawBeziersPoint(ByVal e As PaintEventArgs)

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

    ' Create points for curve.
    Dim start As New Point(100, 100)
    Dim control1 As New Point(200, 10)
    Dim control2 As New Point(350, 50)
    Dim end1 As New Point(500, 100)
    Dim control3 As New Point(600, 150)
    Dim control4 As New Point(650, 250)
    Dim end2 As New Point(500, 300)
    Dim bezierPoints As Point() = {start, control1, control2, _
    end1, control3, control4, end2}

    ' Draw arc to screen.
    e.Graphics.DrawBeziers(blackPen, bezierPoints)
End Sub

Comentarios

El número de puntos de la matriz debe ser un múltiplo de 3 más 1 porque la primera spline requiere 4 puntos y cualquier otra spline requiere 3 puntos cada uno. La primera spline bézier se dibuja desde el primer punto hasta el cuarto punto de la matriz de puntos. Los puntos segundo y tercero son puntos de control que determinan la forma de la curva. Cada curva posterior necesita exactamente tres puntos más: dos puntos de control más y un punto final. El punto final de la curva anterior se usa como punto de partida para cada curva adicional.

DrawBeziers(Pen, PointF[])

Source:

Graphics.cs

Dibuja una serie de splines bézier de una matriz de estructuras PointF.

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

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

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

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

Parámetros

pen

Pen

Pen que determina el color, el ancho y el estilo de la curva.

points

PointF[]

Matriz de PointF estructuras que representan los puntos que determinan la curva. El número de puntos de la matriz debe ser un múltiplo de 3 más 1, como 4, 7 o 10.

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 los puntos de control inicial, final y dos para una primera curva y un punto de conexión y dos puntos de control para una segunda curva.

• Dibuja las sucesivas curvas bézier en la pantalla.

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

      // Create points for curve.
      PointF start = PointF(100.0F,100.0F);
      PointF control1 = PointF(200.0F,10.0F);
      PointF control2 = PointF(350.0F,50.0F);
      PointF end1 = PointF(500.0F,100.0F);
      PointF control3 = PointF(600.0F,150.0F);
      PointF control4 = PointF(650.0F,250.0F);
      PointF end2 = PointF(500.0F,300.0F);
      array<PointF>^ bezierPoints = {start,control1,control2,end1,control3,control4,end2};

      // Draw arc to screen.
      e->Graphics->DrawBeziers( blackPen, bezierPoints );
   }

private void DrawBeziersPointF(PaintEventArgs e)
{
    // Create pen.
    Pen blackPen = new Pen(Color.Black, 3);
             
    // Create points for curve.
    PointF start = new PointF(100.0F, 100.0F);
    PointF control1 = new PointF(200.0F, 10.0F);
    PointF control2 = new PointF(350.0F, 50.0F);
    PointF end1 = new PointF(500.0F, 100.0F);
    PointF control3 = new PointF(600.0F, 150.0F);
    PointF control4 = new PointF(650.0F, 250.0F);
    PointF end2 = new PointF(500.0F, 300.0F);
    PointF[] bezierPoints = { start, control1, control2, end1,
         control3, control4, end2 };      
                 
    // Draw arc to screen.
    e.Graphics.DrawBeziers(blackPen, bezierPoints);
}

Private Sub DrawBeziersPointF(ByVal e As PaintEventArgs)

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

    ' Create points for curve.
    Dim start As New PointF(100.0F, 100.0F)
    Dim control1 As New PointF(200.0F, 10.0F)
    Dim control2 As New PointF(350.0F, 50.0F)
    Dim end1 As New PointF(500.0F, 100.0F)
    Dim control3 As New PointF(600.0F, 150.0F)
    Dim control4 As New PointF(650.0F, 250.0F)
    Dim end2 As New PointF(500.0F, 300.0F)
    Dim bezierPoints As PointF() = {start, control1, control2, _
    end1, control3, control4, end2}

    ' Draw arc to screen.
    e.Graphics.DrawBeziers(blackPen, bezierPoints)
End Sub

Comentarios

El número de puntos de la matriz debe ser un múltiplo de 3 más 1 porque la primera spline requiere 4 puntos y cualquier otra spline requiere 3 puntos cada uno. La primera curva Bézier se dibuja desde el primer punto hasta el cuarto punto de la matriz de puntos. Los puntos segundo y tercero son puntos de control que determinan la forma de la curva. Cada curva posterior necesita exactamente tres puntos más: dos puntos de control más y un punto final. El punto final de la curva anterior se usa como punto de partida para cada curva adicional.