Graphics.DrawBeziers 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 splines Bézier de uma matriz de estruturas Point.

Sobrecargas

DrawBeziers(Pen, Point[])	Desenha uma série de splines Bézier de uma matriz de estruturas Point.
DrawBeziers(Pen, PointF[])	Desenha uma série de splines Bézier de uma matriz de estruturas PointF.

DrawBeziers(Pen, Point[])

Origem:

Graphics.cs

Desenha uma série de splines Bézier de uma matriz de estruturas 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 a cor, a largura e o estilo da curva.

points

Point[]

Matriz de estruturas de Point que representam os pontos que determinam a curva. O número de pontos na matriz deve ser um múltiplo de 3 mais 1, como 4, 7 ou 10.

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 o início, o fim e dois pontos de controle para uma primeira curva e ponto de extremidade e dois pontos de controle para uma segunda curva.

• Desenha as curvas sucessivas de Bézier para a tela.

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

Comentários

O número de pontos na matriz deve ser um múltiplo de 3 mais 1 porque o primeiro spline requer 4 pontos e qualquer outro spline requer 3 pontos cada. O primeiro spline Bézier é desenhado do primeiro ponto para o quarto ponto na matriz de pontos. O segundo e o terceiro pontos são pontos de controle que determinam a forma da curva. Cada curva subsequente precisa exatamente de mais três pontos: mais dois pontos de controle e um ponto final. O ponto final da curva anterior é usado como ponto de partida para cada curva adicional.

DrawBeziers(Pen, PointF[])

Origem:

Graphics.cs

Desenha uma série de splines Bézier de uma matriz de estruturas 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 a cor, a largura e o estilo da curva.

points

PointF[]

Matriz de estruturas de PointF que representam os pontos que determinam a curva. O número de pontos na matriz deve ser um múltiplo de 3 mais 1, como 4, 7 ou 10.

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 o início, o fim e dois pontos de controle para uma primeira curva e ponto de extremidade e dois pontos de controle para uma segunda curva.

• Desenha as curvas sucessivas de Bézier para a tela.

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

Comentários

O número de pontos na matriz deve ser um múltiplo de 3 mais 1 porque o primeiro spline requer 4 pontos e qualquer outro spline requer 3 pontos cada. A primeira curva de Bézier é desenhada do primeiro ponto para o quarto ponto na matriz de pontos. O segundo e o terceiro pontos são pontos de controle que determinam a forma da curva. Cada curva subsequente precisa exatamente de mais três pontos: mais dois pontos de controle e um ponto final. O ponto final da curva anterior é usado como ponto de partida para cada curva adicional.