DrawCurve Method (Pen, PointF[])

Graphics::DrawCurve Method (Pen^, array<PointF>^)

 

Draws a cardinal spline through a specified array of PointF structures.

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

public:
void DrawCurve(
	Pen^ pen,
	array<PointF>^ points
)

Parameters

pen
Type: System.Drawing::Pen^

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

points
Type: array<System.Drawing::PointF>^

Array of PointF structures that define the spline.

Exception Condition
ArgumentNullException

pen is null.

-or-

points is null.

This method draws a cardinal spline that passes through each point in the array.

The array of points must contain at least three PointF structures for a curve to be drawn.

This method uses a default tension of 0.5.

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 red and green pens.

  • Creates seven points to define a curve.

  • Draws six red straight lines between the seven points to form an incomplete polygon.

  • Draws an open green curve through the seven points.

The method uses a default tension of 0.5.

private:
   void DrawCurvePointF( PaintEventArgs^ e )
   {
      // Create pens.
      Pen^ redPen = gcnew Pen( Color::Red,3.0f );
      Pen^ greenPen = gcnew Pen( Color::Green,3.0f );

      // Create points that define curve.
      PointF point1 = PointF(50.0F,50.0F);
      PointF point2 = PointF(100.0F,25.0F);
      PointF point3 = PointF(200.0F,5.0F);
      PointF point4 = PointF(250.0F,50.0F);
      PointF point5 = PointF(300.0F,100.0F);
      PointF point6 = PointF(350.0F,200.0F);
      PointF point7 = PointF(250.0F,250.0F);
      array<PointF>^ curvePoints = {point1,point2,point3,point4,point5,point6,point7};

      // Draw lines between original points to screen.
      e->Graphics->DrawLines( redPen, curvePoints );

      // Draw curve to screen.
      e->Graphics->DrawCurve( greenPen, curvePoints );
   }

.NET Framework
Available since 1.1
Return to top
Show:
© 2016 Microsoft