Graphics.FillClosedCurve(const Brush*, const Point*, INT, FillMode, REAL) method

Applies to: desktop apps only

The Graphics::FillClosedCurve method creates a closed cardinal spline from an array of points and uses a brush to fill, according to a specified mode, the interior of the spline.

Syntax

Status FillClosedCurve(
  [in]  const Brush *brush,
  [in]  const Point *points,
  [in]  INT count,
  [in]  FillMode fillMode,
  [in]  REAL tension
);

Parameters

  • brush [in]
    Type: const Brush*

    Pointer to a Brush object that is used to paint the interior of the spline.

  • points [in]
    Type: const Point*

    Pointer to an array of points that this method uses to create a closed cardinal spline. Each point in the array is a point on the spline.

  • count [in]
    Type: INT

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

  • fillMode [in]
    Type: FillMode

    Element of the FillMode enumeration that specifies how to fill a closed area that is created when the curve passes over itself.

  • tension [in]
    Type: REAL

    Optional. Nonnegative real number that specifies how tightly the spline bends as it passes through the points. A value of 0 specifies that the spline is a sequence of straight lines. As the value increases, the curve becomes fuller. The default value is 0.5f.

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.

Examples

The following example fills a closed cardinal spline using FillModeAlternate as the fill mode.

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

   //Create a SolidBrush object.
   SolidBrush blackBrush(Color(255, 0, 0, 0));

   //Create an array of Point objects.
   Point point1(100, 100);
   Point point2(200, 50);
   Point point3(250, 200);
   Point point4(50, 150);
   Point points[4] = {point1, point2, point3, point4};

   //Fill the curve.
   graphics.FillClosedCurve(&blackBrush, points, 4, FillModeAlternate, 1.0);
}

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

Brush

FillMode

Point

Drawing Cardinal Splines

Open and Closed Curves

Cardinal Splines

Brushes and Filled Shapes

 

 

Send comments about this topic to Microsoft

Build date: 3/6/2012