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

Artikel
08/24/2023

Die GraphicsPath::AddBeziers-Methode fügt der aktuellen Abbildung dieses Pfads eine Sequenz verbundener Bézier-Splines hinzu.

Syntax

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

Parameter

points

Zeiger auf ein Array von Startpunkten, Endpunkten und Steuerungspunkten für die verbundenen Splines. Der erste Spline wird vom ersten Punkt bis zum vierten Punkt im Array erstellt und verwendet den zweiten und dritten Punkt als Kontrollpunkte. Jeder nachfolgende Spline in der Sequenz benötigt genau drei weitere Punkte: Der Endpunkt des vorherigen Splines wird als Ausgangspunkt verwendet, die nächsten beiden Punkte in der Sequenz sind Kontrollpunkte, und der dritte Punkt ist der Endpunkt.

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.

Bemerkungen

Beispiele

Das folgende Beispiel erstellt einen GraphicsPath-Objektpfad , fügt dem Pfad eine Sequenz von zwei verbundenen Bézier-Splines hinzu, schließt die aktuelle Abbildung (in diesem Fall die einzige Abbildung) und zeichnet dann den Pfad.

VOID Example_AddBeziers(HDC hdc)
{
   Graphics graphics(hdc);
   GraphicsPath  path;

   Point pts[] = {Point(50,50),
                  Point(60,20),
                  Point(70,100),
                  Point(80,50),
                  Point(120,40),
                  Point(150,80),
                  Point(170,30)};

   path.AddBeziers(pts, 7);
   path.CloseFigure();

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