Graphics.DrawClosedCurve Methode

Definition

Namespace:

System.Drawing

Assembly:

System.Drawing.Common.dll

Paket:

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

Zeichnet eine geschlossene Kardinalspline, die durch ein Array von Point Strukturen definiert wird.

Überlädt

DrawClosedCurve(Pen, PointF[], Single, FillMode)	Zeichnet eine geschlossene Kardinalspline, die durch ein Array von PointF Strukturen mit einer angegebenen Spannung definiert wird.
DrawClosedCurve(Pen, Point[], Single, FillMode)	Zeichnet eine geschlossene Kardinalspline, die durch ein Array von Point Strukturen mit einer angegebenen Spannung definiert wird.
DrawClosedCurve(Pen, Point[])	Zeichnet eine geschlossene Kardinalspline, die durch ein Array von Point Strukturen definiert wird.
DrawClosedCurve(Pen, PointF[])	Zeichnet eine geschlossene Kardinalspline, die durch ein Array von PointF Strukturen definiert wird.

DrawClosedCurve(Pen, PointF[], Single, FillMode)

Quelle:

Graphics.cs

Zeichnet eine geschlossene Kardinalspline, die durch ein Array von PointF Strukturen mit einer angegebenen Spannung definiert wird.

C#

public void DrawClosedCurve (System.Drawing.Pen pen, System.Drawing.PointF[] points, float tension, System.Drawing.Drawing2D.FillMode fillmode);

Parameter

pen

Pen

Pen, die die Farbe, Breite und Höhe der Kurve bestimmt.

points

PointF[]

Array von PointF Strukturen, die die Spline definieren.

tension

Single

Wert größer oder gleich 0,0F, der die Spannung der Kurve angibt.

fillmode

FillMode

Member der FillMode-Aufzählung, die bestimmt, wie die Kurve gefüllt wird. Dieser Parameter ist erforderlich, wird jedoch ignoriert.

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 rote und grüne Stifte.

• Erstellt sieben Punkte, um die Kurve zu definieren.

• Zeichnet sieben rote gerade Linien zwischen den sieben Punkten, um ein Polygon zu bilden.

• Erstellt Spannungs- und Füllmoduseinstellungen.

• Zeichnet eine grüne geschlossene Kurve durch die sieben Punkte.

Die Methode verwendet eine Spannung von 1,0 und legt den Füllmodus auf FillMode.Alternate.

C#

private void DrawClosedCurvePointFTension(PaintEventArgs e)
{

    // Create pens.
    Pen redPen = new Pen(Color.Red, 3);
    Pen greenPen = new Pen(Color.Green, 3);

    // Create points that define curve.
    PointF point1 = new PointF(50.0F, 50.0F);
    PointF point2 = new PointF(100.0F, 25.0F);
    PointF point3 = new PointF(200.0F, 5.0F);
    PointF point4 = new PointF(250.0F, 50.0F);
    PointF point5 = new PointF(300.0F, 100.0F);
    PointF point6 = new PointF(350.0F, 200.0F);
    PointF point7 = new PointF(250.0F, 250.0F);
    PointF[] curvePoints = {point1, point2, point3, point4, point5, point6, point7};

    // Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints);

    // Create tension and fill mode.
    float tension = 1.0F;
    FillMode aFillMode = FillMode.Alternate;

    // Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints, tension, aFillMode);
}

Hinweise

Diese Methode zeichnet eine geschlossene Kardinalspline, die jeden Punkt im Array durchläuft. Wenn der letzte Punkt nicht mit dem ersten Punkt übereinstimmt, wird ein zusätzliches Kurvensegment vom letzten Punkt zum ersten Punkt hinzugefügt, um ihn zu schließen.

Das Array von Punkten muss mindestens vier PointF Strukturen enthalten.

Der tension-Parameter bestimmt die Form der Spline. Wenn der Wert des tension-Parameters 0,0F ist, zeichnet diese Methode gerade Liniensegmente, um die Punkte zu verbinden. Normalerweise ist der tension Parameter kleiner oder gleich 1,0F. Werte über 1,0F erzeugen ungewöhnliche Ergebnisse.

DrawClosedCurve(Pen, Point[], Single, FillMode)

Quelle:

Graphics.cs

Zeichnet eine geschlossene Kardinalspline, die durch ein Array von Point Strukturen mit einer angegebenen Spannung definiert wird.

C#

public void DrawClosedCurve (System.Drawing.Pen pen, System.Drawing.Point[] points, float tension, System.Drawing.Drawing2D.FillMode fillmode);

Parameter

pen

Pen

Pen, die die Farbe, Breite und Höhe der Kurve bestimmt.

points

Point[]

Array von Point Strukturen, die die Spline definieren.

tension

Single

Wert größer oder gleich 0,0F, der die Spannung der Kurve angibt.

fillmode

FillMode

Member der FillMode-Aufzählung, die bestimmt, wie die Kurve gefüllt wird. Dieser Parameter ist erforderlich, wird jedoch ignoriert.

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 rote und grüne Stifte.

• Erstellt sieben Punkte, um die Kurve zu definieren.

• Zeichnet sieben rote gerade Linien zwischen den sieben Punkten, um ein Polygon zu bilden.

• Erstellt Spannungs- und Füllmoduseinstellungen.

• Zeichnet eine grüne geschlossene Kurve durch die sieben Punkte.

Die Methode verwendet eine Spannung von 1,0 und legt den Füllmodus auf FillMode.Alternate.

C#

private void DrawClosedCurvePointTension(PaintEventArgs e)
{

    // Create pens.
    Pen redPen = new Pen(Color.Red, 3);
    Pen greenPen = new Pen(Color.Green, 3);

    // Create points that define curve.
    Point point1 = new Point(50, 50);
    Point point2 = new Point(100, 25);
    Point point3 = new Point(200, 5);
    Point point4 = new Point(250, 50);
    Point point5 = new Point(300, 100);
    Point point6 = new Point(350, 200);
    Point point7 = new Point(250, 250);
    Point[] curvePoints = {point1, point2, point3, point4, point5, point6, point7};

    // Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints);

    // Create tension and fill mode.
    float tension = 1.0F;
    FillMode aFillMode = FillMode.Alternate;

    // Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints, tension, aFillMode);
}

Hinweise

Diese Methode zeichnet eine geschlossene Kardinalspline, die jeden Punkt im Array durchläuft. Wenn der letzte Punkt nicht mit dem ersten Punkt übereinstimmt, wird ein zusätzliches Kurvensegment vom letzten Punkt zum ersten Punkt hinzugefügt, um ihn zu schließen.

Das Array von Punkten muss mindestens vier Point Strukturen enthalten.

Der tension-Parameter bestimmt die Form der Spline. Wenn der Wert des tension-Parameters 0,0F ist, zeichnet diese Methode gerade Liniensegmente, um die Punkte zu verbinden. Normalerweise ist der tension Parameter kleiner oder gleich 1,0F. Werte über 1,0F erzeugen ungewöhnliche Ergebnisse.

DrawClosedCurve(Pen, Point[])

Quelle:

Graphics.cs

Zeichnet eine geschlossene Kardinalspline, die durch ein Array von Point Strukturen definiert wird.

C#

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

Parameter

pen

Pen

Pen, die die Farbe, Breite und Höhe der Kurve bestimmt.

points

Point[]

Array von Point Strukturen, die die Spline definieren.

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 rote und grüne Stifte.

• Erstellt sieben Punkte, um eine Kurve zu definieren.

• Zeichnet sieben rote gerade Linien zwischen den sieben Punkten, um ein geschlossenes Polygon zu bilden.

• Zeichnet eine grüne geschlossene Kurve durch die sieben Punkte.

Die Methode verwendet eine Standardspannung von 0,5.

C#

private void DrawClosedCurvePoint(PaintEventArgs e)
{
    // Create pens.
    Pen redPen   = new Pen(Color.Red, 3);
    Pen greenPen = new Pen(Color.Green, 3);
             
    // Create points that define curve.
    Point point1 = new Point(50,  50);
    Point point2 = new Point(100,  25);
    Point point3 = new Point(200,   5);
    Point point4 = new Point(250,  50);
    Point point5 = new Point(300, 100);
    Point point6 = new Point(350, 200);
    Point point7 = new Point(250, 250);
    Point[] curvePoints =
             {
                 point1,
                 point2,
                 point3,
                 point4,
                 point5,
                 point6,
                 point7
             };
             
    // Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints);
             
    // Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints);
}

Hinweise

Diese Methode zeichnet eine geschlossene Kardinalspline, die jeden Punkt im Array durchläuft. Wenn der letzte Punkt nicht mit dem ersten Punkt übereinstimmt, wird ein zusätzliches Kurvensegment vom letzten Punkt zum ersten Punkt hinzugefügt, um die Abbildung zu schließen.

Das Array von Punkten muss mindestens vier Point Strukturen enthalten.

Diese Methode verwendet eine Standardspannung von 0,5.

DrawClosedCurve(Pen, PointF[])

Quelle:

Graphics.cs

Zeichnet eine geschlossene Kardinalspline, die durch ein Array von PointF Strukturen definiert wird.

C#

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

Parameter

pen

Pen

Pen, die die Farbe, Breite und Höhe der Kurve bestimmt.

points

PointF[]

Array von PointF Strukturen, die die Spline definieren.

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 rote und grüne Stifte.

• Erstellt sieben Punkte, um eine Kurve zu definieren.

• Zeichnet sieben rote gerade Linien zwischen den sieben Punkten, um ein geschlossenes Polygon zu bilden.

• Zeichnet eine grüne geschlossene Kurve durch die sieben Punkte.

Die Methode verwendet eine Standardspannung von 0,5.

C#

private void DrawClosedCurvePointF(PaintEventArgs e)
{

    // Create pens.
    Pen redPen = new Pen(Color.Red, 3);
    Pen greenPen = new Pen(Color.Green, 3);

    // Create points that define curve.
    PointF point1 = new PointF(50.0F, 50.0F);
    PointF point2 = new PointF(100.0F, 25.0F);
    PointF point3 = new PointF(200.0F, 5.0F);
    PointF point4 = new PointF(250.0F, 50.0F);
    PointF point5 = new PointF(300.0F, 100.0F);
    PointF point6 = new PointF(350.0F, 200.0F);
    PointF point7 = new PointF(250.0F, 250.0F);
    PointF[] curvePoints = {point1, point2, point3, point4, point5, point6, point7};

    // Draw lines between original points to screen.
    e.Graphics.DrawLines(redPen, curvePoints);

    // Draw closed curve to screen.
    e.Graphics.DrawClosedCurve(greenPen, curvePoints);
}

Hinweise

Diese Methode zeichnet eine geschlossene Kardinalspline, die jeden Punkt im Array durchläuft. Wenn der letzte Punkt nicht mit dem ersten Punkt übereinstimmt, wird ein zusätzliches Kurvensegment vom letzten Punkt zum ersten Punkt hinzugefügt, um ihn zu schließen.

Das Array von Punkten muss mindestens vier PointF Strukturen enthalten.

Diese Methode verwendet eine Standardspannung von 0,5.