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

Artikel
07/16/2024

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

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

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

Beispiele

Im folgenden Beispiel wird ein GraphicsPath Objektpfad erstellt, eine Sequenz von zwei verbundenen Bézier splines zum Pfad hinzugefügt, die aktuelle Abbildung (die einzige Abbildung in diesem Fall) geschlossen und dann pfadweise zeichnungen.

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