Graphics::DrawBezier Method (Pen^, PointF, PointF, PointF, PointF)

 
System_CAPS_noteNote

The .NET API Reference documentation has a new home. Visit the .NET API Browser on docs.microsoft.com to see the new experience.

Draws a Bézier spline defined by four PointF structures.

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

public:
void DrawBezier(
	Pen^ pen,
	PointF pt1,
	PointF pt2,
	PointF pt3,
	PointF pt4
)

Parameters

pen
Type: System.Drawing::Pen^

Pen that determines the color, width, and style of the curve.

pt1
Type: System.Drawing::PointF

PointF structure that represents the starting point of the curve.

pt2
Type: System.Drawing::PointF

PointF structure that represents the first control point for the curve.

pt3
Type: System.Drawing::PointF

PointF structure that represents the second control point for the curve.

pt4
Type: System.Drawing::PointF

PointF structure that represents the ending point of the curve.

Exception Condition
ArgumentNullException

pen is null.

The Bézier spline is drawn from the first point to the fourth point. The second and third points are control points that determine the shape of the curve.

The following code example is designed for use with Windows Forms, and it requires PaintEventArgse, which is a parameter of the Paint event handler. The code performs the following actions:

  • Creates a black pen.

  • Creates the start, end, and two control points for the curve.

  • Draws the Bézier curve to the screen.

private:
   void DrawBezierPointF( PaintEventArgs^ e )
   {
      // Create pen.
      Pen^ blackPen = gcnew Pen( Color::Black,3.0f );

      // Create points for curve.
      PointF start = PointF(100.0F,100.0F);
      PointF control1 = PointF(200.0F,10.0F);
      PointF control2 = PointF(350.0F,50.0F);
      PointF end = PointF(500.0F,100.0F);

      // Draw arc to screen.
      e->Graphics->DrawBezier( blackPen, start, control1, control2, end );
   }

.NET Framework
Available since 1.1
Return to top
Show: