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

Artikel
02/26/2024

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

Syntax

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

Parameter

points

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

count

Ganzzahl, die die Anzahl der Elemente im Punktarray angibt.

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.

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