Graphics.DrawBeziers Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

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

Zeichnet eine Reihe von Bézier splines aus einem Array von Point Strukturen.

Überlädt

DrawBeziers(Pen, Point[])	Zeichnet eine Reihe von Bézier splines aus einem Array von Point Strukturen.
DrawBeziers(Pen, PointF[])	Zeichnet eine Reihe von Bézier splines aus einem Array von PointF Strukturen.

DrawBeziers(Pen, Point[])

Quelle:

Graphics.cs

Zeichnet eine Reihe von Bézier splines aus einem Array von Point Strukturen.

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())

Parameter

pen

Pen

Pen, die die Farbe, Breite und Formatvorlage der Kurve bestimmt.

points

Point[]

Array von Point Strukturen, die die Punkte darstellen, die die Kurve bestimmen. Die Anzahl der Punkte im Array sollte ein Vielfaches von 3 plus 1 sein, z. B. 4, 7 oder 10.

Ausnahmen

ArgumentNullException

pen ist null.

-oder-

points ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt einen schwarzen Stift.

• Erstellt den Anfang, das Ende und zwei Kontrollpunkte für eine erste Kurve und einen Endpunkt sowie zwei Kontrollpunkte für eine zweite Kurve.

• Zeichnet die aufeinander folgenden Bézierkurven auf den Bildschirm.

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

Hinweise

Die Anzahl der Punkte im Array sollte ein Vielfaches von 3 plus 1 sein, da die erste Spline 4 Punkt erfordert und alle anderen Splines jeweils 3 Punkte erfordern. Die erste Bézier-Spline wird vom ersten Punkt bis zum vierten Punkt im Punktarray gezeichnet. Die zweiten und dritten Punkte sind Kontrollpunkte, die die Form der Kurve bestimmen. Jede nachfolgende Kurve benötigt genau drei weitere Punkte: zwei weitere Kontrollpunkte und einen Endpunkt. Der Endpunkt der vorherigen Kurve wird als Ausgangspunkt für jede zusätzliche Kurve verwendet.

DrawBeziers(Pen, PointF[])

Quelle:

Graphics.cs

Zeichnet eine Reihe von Bézier splines aus einem Array von PointF Strukturen.

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())

Parameter

pen

Pen

Pen, die die Farbe, Breite und Formatvorlage der Kurve bestimmt.

points

PointF[]

Array von PointF Strukturen, die die Punkte darstellen, die die Kurve bestimmen. Die Anzahl der Punkte im Array sollte ein Vielfaches von 3 plus 1 sein, z. B. 4, 7 oder 10.

Ausnahmen

ArgumentNullException

pen ist null.

-oder-

points ist null.

Beispiele

Das folgende Codebeispiel wurde für die Verwendung mit Windows Forms entwickelt und erfordert PaintEventArgse, bei dem es sich um einen Parameter des Paint-Ereignishandlers handelt. Der Code führt die folgenden Aktionen aus:

• Erstellt einen schwarzen Stift.

• Erstellt den Anfang, das Ende und zwei Kontrollpunkte für eine erste Kurve und einen Endpunkt sowie zwei Kontrollpunkte für eine zweite Kurve.

• Zeichnet die aufeinander folgenden Bézierkurven auf den Bildschirm.

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

Hinweise

Die Anzahl der Punkte im Array sollte ein Vielfaches von 3 plus 1 sein, da die erste Spline 4 Punkt erfordert und alle anderen Splines jeweils 3 Punkte erfordern. Die erste Bézierkurve wird vom ersten Punkt zum vierten Punkt im Punktarray gezeichnet. Die zweiten und dritten Punkte sind Kontrollpunkte, die die Form der Kurve bestimmen. Jede nachfolgende Kurve benötigt genau drei weitere Punkte: zwei weitere Kontrollpunkte und einen Endpunkt. Der Endpunkt der vorherigen Kurve wird als Ausgangspunkt für jede zusätzliche Kurve verwendet.