Graphics.DrawBeziers Metodo

Definizione

Spazio dei nomi:

System.Drawing

Assembly:

System.Drawing.Common.dll

Pacchetto:

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

Disegna una serie di spline di Bézier da una matrice di strutture Point.

Overload

DrawBeziers(Pen, Point[])	Disegna una serie di spline di Bézier da una matrice di strutture Point.
DrawBeziers(Pen, PointF[])	Disegna una serie di spline di Bézier da una matrice di strutture PointF.

DrawBeziers(Pen, Point[])

Origine:

Graphics.cs

Disegna una serie di spline di Bézier da una matrice di strutture 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())

Parametri

pen

Pen

Pen che determina il colore, la larghezza e lo stile della curva.

points

Point[]

Matrice di strutture Point che rappresentano i punti che determinano la curva. Il numero di punti nella matrice deve essere un multiplo di 3 più 1, ad esempio 4, 7 o 10.

Eccezioni

ArgumentNullException

pen è null.

-o-

points è null.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea una penna nera.

• Crea l'inizio, la fine e due punti di controllo per una prima curva e un endpoint e due punti di controllo per una seconda curva.

• Disegna le curve di Bézier successive sullo schermo.

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

Commenti

Il numero di punti nella matrice deve essere un multiplo di 3 più 1 perché la prima spline richiede 4 punti e qualsiasi altra spline richiede 3 punti ciascuno. La prima spline di Bézier viene disegnata dal primo punto al quarto punto della matrice di punti. Il secondo e il terzo punto sono punti di controllo che determinano la forma della curva. Ogni curva successiva richiede esattamente tre punti in più: due punti di controllo e un punto finale. Il punto finale della curva precedente viene usato come punto iniziale per ogni curva aggiuntiva.

DrawBeziers(Pen, PointF[])

Origine:

Graphics.cs

Disegna una serie di spline di Bézier da una matrice di strutture 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())

Parametri

pen

Pen

Pen che determina il colore, la larghezza e lo stile della curva.

points

PointF[]

Matrice di strutture PointF che rappresentano i punti che determinano la curva. Il numero di punti nella matrice deve essere un multiplo di 3 più 1, ad esempio 4, 7 o 10.

Eccezioni

ArgumentNullException

pen è null.

-o-

points è null.

Esempio

L'esempio di codice seguente è progettato per l'uso con Windows Form e richiede PaintEventArgse, che è un parametro del gestore eventi Paint. Il codice esegue le azioni seguenti:

• Crea una penna nera.

• Crea l'inizio, la fine e due punti di controllo per una prima curva e un endpoint e due punti di controllo per una seconda curva.

• Disegna le curve di Bézier successive sullo schermo.

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

Commenti

Il numero di punti nella matrice deve essere un multiplo di 3 più 1 perché la prima spline richiede 4 punti e qualsiasi altra spline richiede 3 punti ciascuno. La prima curva di Bézier viene disegnata dal primo punto al quarto punto della matrice di punti. Il secondo e il terzo punto sono punti di controllo che determinano la forma della curva. Ogni curva successiva richiede esattamente tre punti in più: due punti di controllo e un punto finale. Il punto finale della curva precedente viene usato come punto iniziale per ogni curva aggiuntiva.