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

Artikel
07/16/2024

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

Syntax

Status AddCurve(
  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 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, dem Pfad eine Kardinalspline hinzugefügt und anschließend der Pfad bezieht.

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