Auf Englisch lesen

Teilen über


Graphics.DrawBeziers Methode

Definition

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, ReadOnlySpan<Point>)
DrawBeziers(Pen, ReadOnlySpan<PointF>)

DrawBeziers(Pen, Point[])

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

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

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

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

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.

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

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.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

DrawBeziers(Pen, PointF[])

Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs
Quelle:
Graphics.cs

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

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

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

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.

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

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.

Gilt für:

.NET 9 und andere Versionen
Produkt Versionen
.NET 6, 7, 8, 9
.NET Framework 1.1, 2.0, 3.0, 3.5, 4.0, 4.5, 4.5.1, 4.5.2, 4.6, 4.6.1, 4.6.2, 4.7, 4.7.1, 4.7.2, 4.8, 4.8.1
.NET Standard 2.0
Windows Desktop 3.0, 3.1, 5, 6, 7, 8, 9

DrawBeziers(Pen, ReadOnlySpan<Point>)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
C#
public void DrawBeziers (System.Drawing.Pen pen, scoped ReadOnlySpan<System.Drawing.Point> points);

Parameter

pen
Pen

Gilt für:

.NET 9 und Windows Desktop 9
Produkt Versionen
.NET 9
Windows Desktop 9

DrawBeziers(Pen, ReadOnlySpan<PointF>)

Quelle:
Graphics.cs
Quelle:
Graphics.cs
C#
public void DrawBeziers (System.Drawing.Pen pen, scoped ReadOnlySpan<System.Drawing.PointF> points);

Parameter

pen
Pen

Gilt für:

.NET 9 und Windows Desktop 9
Produkt Versionen
.NET 9
Windows Desktop 9