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

Artikel
07/16/2024

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

Syntax

Status AddClosedCurve(
  const PointF *points,
  INT          count
);

Parameter

points

Zeigen Sie auf ein Array von Punkten, die die Kardinalspline definieren. Die Kardinalspline ist eine Kurve, die jeden Punkt im Array durchläuft.

count

Ganze Zahl, die die Anzahl der Elemente im Punktarray angibt.

Rückgabewert

Typ:Status

Wenn die Methode erfolgreich ist, wird Ok zurückgegeben, bei dem es sich um ein Element der Status Enumeration handelt.

Wenn die Methode fehlschlägt, wird eines der anderen Elemente der Status Enumeration zurückgegeben.

Bemerkungen

Sie sollten eine Kopie des Punktearrays beibehalten, wenn diese Punkte später benötigt werden. Das GraphicsPath--Objekt speichert die an die GraphicsPath::AddClosedCurve Methode übergebenen Punkte nicht. Stattdessen wird die Kardinalspline in eine Abfolge von Bézier-Splines konvertiert und die Punkte gespeichert, 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, eine geschlossene Kardinalspline zum Pfad hinzugefügt und dann pfadlos geschlagen.

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

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