GraphicsPath.AddBeziers Method

Definition

Namespace:

System.Drawing.Drawing2D

Assembly:

System.Drawing.Common.dll

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

Overloads

AddBeziers(Point[])	Adds a sequence of connected cubic Bézier curves to the current figure.
AddBeziers(PointF[])	Adds a sequence of connected cubic Bézier curves to the current figure.

AddBeziers(Point[])

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

public:
 void AddBeziers(... cli::array <System::Drawing::Point> ^ points);

public void AddBeziers (params System.Drawing.Point[] points);

member this.AddBeziers : System.Drawing.Point[] -> unit

Public Sub AddBeziers (ParamArray points As Point())

Parameters

points

Point[]

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

Examples

The following code example is designed for use with Windows Forms, and it requires PaintEventArgs e, 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.
      array<Point>^ myArray = {Point(20,100),Point(40,75),Point(60,125),Point(80,100),Point(100,50),Point(120,150),Point(140,100)};

      // Create the path and add the curves.
      GraphicsPath^ myPath = gcnew GraphicsPath;
      myPath->AddBeziers( myArray );

      // Draw the path to the screen.
      Pen^ myPen = gcnew Pen( Color::Black,2.0f );
      e->Graphics->DrawPath( myPen, myPath );
   }

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

Public Sub AddBeziersExample(ByVal e As PaintEventArgs)

    ' Adds two Bezier curves.
    Dim myArray As Point() = {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)}
    Dim myPath As New GraphicsPath
    myPath.AddBeziers(myArray)
    Dim myPen As New Pen(Color.Black, 2)
    e.Graphics.DrawPath(myPen, myPath)
End Sub

Remarks

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.

AddBeziers(PointF[])

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

public:
 void AddBeziers(cli::array <System::Drawing::PointF> ^ points);

public void AddBeziers (System.Drawing.PointF[] points);

member this.AddBeziers : System.Drawing.PointF[] -> unit

Public Sub AddBeziers (points As PointF())

Parameters

points

PointF[]

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

Examples

For an example see:

AddBeziers(Point[])

Remarks

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.