GraphicsPath::AddClosedCurve(constPointF*,INT,REAL)-Methode (gdipluspath.h)
Die GraphicsPath::AddClosedCurve-Methode fügt diesem Pfad eine geschlossene Kardinalspline hinzu.
Syntax
Status AddClosedCurve(
[in] const PointF *points,
[in] INT count,
[in] REAL tension
);
Parameter
[in] points
Typ: const PointF*
Zeiger auf ein Array von Punkten, die die Kardinalspline definieren. Die 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 negative reelle Zahl, die die Länge der Kurve und die Art der Kurve steuert. Der Wert 0 gibt an, dass der Spline eine Sequenz gerader Liniensegmente ist. Wenn der Wert zunimmt, 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, wird eines der anderen Elemente der Status-Enumeration zurückgegeben.
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, dem Pfad ein geschlossener Kardinalspline hinzugefügt und dann der Pfad zeichnet. zeichnet. Die Spannung ist auf 1,0 festgelegt.
VOID Example_AddClosedCurve(HDC hdc)
{
Graphics graphics(hdc);
PointF pts[] = {PointF(50.0f,50.0f),
PointF(60.0f,20.0f),
PointF(70.0f,100.0f),
PointF(80.0f,50.0f)};
GraphicsPath path;
path.AddClosedCurve(pts, 4, 1.0f);
// Draw the path.
Pen pen(Color(255, 255, 0, 0));
graphics.DrawPath(&pen, &path);
}
Anforderungen
| Unterstützte Mindestversion (Client) | Windows XP, Windows 2000 Professional [nur Desktop-Apps] |
| Unterstützte Mindestversion (Server) | Windows 2000 Server [nur Desktop-Apps] |
| Zielplattform | Windows |
| Kopfzeile | gdipluspath.h (include Gdiplus.h) |
| Bibliothek | Gdiplus.lib |
| DLL | Gdiplus.dll |