Graphics.DrawCurve(const Pen*, const PointF*, INT) method

Applies to: desktop apps only

The Graphics::DrawCurve method draws a cardinal spline.

Syntax

Status DrawCurve(
  [in]  const Pen *pen,
  [in]  const PointF *points,
  [in]  INT count
);

Parameters

• pen [in]
  Type: const Pen*

  Pointer to a pen used to draw the cardinal spline.

• points [in]
  Type: const PointF*

  Pointer to an array of PointF objects that specify the coordinates that the cardinal spline passes through.

• count [in]
  Type: INT

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

Return value

Type:

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

A segment is defined as a curve that connects two consecutive points in the cardinal spline. The ending point of each segment is the starting point for the next.

Examples

The following example draws a cardinal spline.

VOID Example_DrawCurve4(HDC hdc)
{
   Graphics graphics(hdc);

   // Define a Pen object and an array of Point objects.
   Pen greenPen(Color::Green, 3);
   PointF point1(100.0f, 100.0f);
   PointF point2(200.0f, 50.0f);
   PointF point3(400.0f, 10.0f);
   PointF point4(500.0f, 100.0f); 

   PointF curvePoints[4] = {
   point1,
   point2,
   point3,
   point4};

   PointF* pcurvePoints = curvePoints;

   // Draw the curve.
   graphics.DrawCurve(&greenPen, curvePoints, 4);

   //Draw the points in the curve.
   SolidBrush redBrush(Color::Red);
   graphics.FillEllipse(&redBrush, Rect(95, 95, 10, 10));
   graphics.FillEllipse(&redBrush, Rect(195, 45, 10, 10));
   graphics.FillEllipse(&redBrush, Rect(395, 5, 10, 10));
   graphics.FillEllipse(&redBrush, Rect(495, 95, 10, 10));
}

Requirements

Minimum supported client	Windows XP, Windows 2000 Professional
Minimum supported server	Windows 2000 Server
Product	GDI+ 1.0
Header	Gdiplusgraphics.h (include Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll

See also

Graphics

DrawClosedCurve Methods

Pen

Point

Drawing Cardinal Splines

Cardinal Splines

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012