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

Artikel
02/26/2024

Die GraphicsPath::AddCurve-Methode fügt der aktuellen Abbildung dieses Pfads einen Kardinalspline hinzu.

Syntax

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

Parameter

points

Zeiger auf ein Array von Punkten, die den Kardinalspline definieren. Der 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, 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 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 Kardinal-Spline zum Pfad hinzugefügt und dann der Pfad gezogen.

VOID AddCurveExample(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.AddCurve(pts, 4);
   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}