GraphicsPath.AddBeziers Method (Point[])

 

Adds a sequence of connected cubic Bézier curves to the current figure.

Namespace:   System.Drawing.Drawing2D
Assembly:  System.Drawing (in System.Drawing.dll)

public void AddBeziers(
	params Point[] points
)

Parameters

points
Type: System.Drawing.Point[]

An array of Point structures that represents the points that define the curves.

The points parameter specifies an array of endpoints and control points of the connected curves. The first curve is constructed from the first point to the fourth point in the points array by using the second and third points as control points. In addition to the endpoint of the previous curve, each subsequent curve in the sequence needs exactly three more points: the next two points in the sequence are control points, and the third is the endpoint for the added curve.

If there are previous lines or curves in the figure, a line is added to connect the endpoint of the previous segment to the starting point of the first cubic curve in the sequence.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, an OnPaint event object. The code performs the following actions:

  • Creates an array of seven points (representing two connected Bézier curves).

  • Creates a path and adds the series of Bézier curve points to the path.

  • Draws the path to screen.

private void AddBeziersExample(PaintEventArgs e)
{

    // Adds two Bezier curves.
    Point[] myArray =
             {
                 new Point(20, 100),
                 new Point(40, 75),
                 new Point(60, 125),
                 new Point(80, 100),
                 new Point(100, 50),
                 new Point(120, 150),
                 new Point(140, 100)
             };

    // Create the path and add the curves.
    GraphicsPath myPath = new GraphicsPath();
    myPath.AddBeziers(myArray);

    // Draw the path to the screen.
    Pen myPen = new Pen(Color.Black, 2);
    e.Graphics.DrawPath(myPen, myPath);
}

.NET Framework
Available since 1.1
Return to top
Show: