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

Article
02/22/2024

The GraphicsPath::AddBeziers method adds a sequence of connected Bézier splines to the current figure of this path.

Syntax

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

Parameters

points

Pointer to an array of starting points, ending points, and control points for the connected splines. The first spline is constructed from the first point through the fourth point in the array and uses the second and third points as control points. Each subsequent spline in the sequence needs exactly three more points: the ending point of the previous spline is used as the starting point, the next two points in the sequence are control points, and the third point is the ending point.

count

Integer that specifies the number of elements in the points array.

Return value

Type: Status

If the method succeeds, it returns Ok, which is an element of the Status enumeration.

If the method fails, it returns one of the other elements of the Status enumeration.

Remarks

Examples

The following example creates a GraphicsPath object path, adds a sequence of two connected Bézier splines to path, closes the current figure (the only figure in this case), and then draws path.

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

Requirements

Requirement	Value
Header	gdipluspath.h