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

Artikel
02/26/2024

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

Syntax

Status AddCurve(
  [in] const Point *points,
  [in] INT         count
);

Parameter

[in] points

Typ: const Point*

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

INT , das 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 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 eine kardinale Spline hinzugefügt und dann der Pfad zeichnet.

VOID AddCurveExample(HDC hdc)
{
   Graphics graphics(hdc);
   Point pts[] = {Point(50,50),
                  Point(60,20),
                  Point(70,100),
                  Point(80,50)};
   GraphicsPath path;
   path.AddCurve(pts, 4);
   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);   
}

Anforderungen

Anforderung	Wert
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