GraphicsPath::AddClosedCurve(constPoint*,INT,REAL)-Methode (gdipluspath.h)

Die GraphicsPath::AddClosedCurve-Methode fügt diesem Pfad eine geschlossene Kardinalspline hinzu.

Syntax

Status AddClosedCurve(
  [in] const Point *points,
  [in] INT         count,
  [in] REAL        tension
);

Parameter

[in] points

Typ: const Point*

Zeiger auf ein Array von Punkten, die den Kardinalspline definieren. Der Kardinalspline ist eine Kurve, die jeden Punkt im Array durchläuft.

[in] count

Typ: INT

Ganzzahl, die die Anzahl der Elemente im Punktarray angibt.

[in] tension

Typ: REAL

Nicht abegative reelle Zahl, die die Länge der Kurve und die Krümmung der Kurve steuert. Der Wert 0 gibt an, dass es sich bei dem Spline um eine Sequenz gerader Linien handelt. Wenn der Wert steigt, wird die Kurve voller.

Rückgabewert

Typ: Status

Wenn die Methode erfolgreich ist, gibt sie OK zurück, ein Element der Status-Enumeration .

Wenn die Methode fehlschlägt, gibt sie eines der anderen Elemente der Status-Enumeration zurück.

Hinweise

Sie sollten eine Kopie des Punktearrays aufbewahren, wenn diese Punkte später benötigt werden. Das GraphicsPath-Objekt speichert die An die GraphicsPath::AddClosedCurve-Methode übergebenen Punkte nicht. Stattdessen konvertiert er den Kardinalspline in eine Sequenz von Bézier-Splines und speichert die Punkte, die diese Bézier-Splines definieren. Sie können das ursprüngliche Array von Punkten nicht aus dem GraphicsPath-Objekt abrufen.

Beispiele

Im folgenden Beispiel wird ein GraphicsPath-Objektpfad erstellt, ein geschlossener Kardinalspline zum Pfad hinzugefügt und dann der Pfad gezogen. Die Spannung ist auf 1,0 festgelegt.

VOID Example_AddClosedCurve(HDC hdc)
{
   Graphics graphics(hdc); 

   Point pts[] = {Point(50,50),
                  Point(60,20),
                  Point(70,100),
                  Point(80,50)};

   GraphicsPath path;
   path.AddClosedCurve(pts, 4, 1.0f);

   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

Anforderungen

Weitere Informationen

AddBezier-Methoden

AddBeziers-Methoden

AddClosedCurve-Methoden

AddCurve-Methoden

Kardinal-Splines

Ausschneiden mit einer Region

Erstellen und Zeichnen von Pfaden

Erstellen eines Pfadverlaufs

Zeichnen kardinaler Splines

Graphicspath

Paths

Point