GraphicsPathIterator::NextPathType method (gdipluspath.h)

Article
10/13/2021

The GraphicsPathIterator::NextPathType method gets the starting index and the ending index of the next group of data points that all have the same type.

Syntax

INT NextPathType(
  [out] BYTE *pathType,
  [out] INT  *startIndex,
  [out] INT  *endIndex
);

Parameters

[out] pathType

Type: BYTE*

Pointer to a BYTE that receives the point type shared by all points in the group. Possible values are PathPointTypeLine and PathPointTypeBezier, which are elements of the PathPointType enumeration.

[out] startIndex

Type: INT*

Pointer to an INT that receives the starting index of the group of points.

[out] endIndex

Type: INT*

Pointer to an INT that receives the ending index of the group of points.

Return value

Type: INT

This method returns the number of data points in the group. If there are no more groups in the path, this method returns 0.

Remarks

A path has an array of data points that define its lines and curves. All curves in the path are represented as Bézier splines, so a given point in the array has one of two types: PathPointTypeLine or PathPointTypeBezier.

The first time you call the GraphicsPathIterator::NextSubpath method of an iterator, it gets the starting and ending indices of the first group of points that all have the same type. The second time, it gets the second group, and so on. Each time you call GraphicsPathIterator::NextSubpath, it returns the number of data points in the obtained group. When there are no groups remaining, it returns 0.

Requirements

Requirement	Value
Minimum supported client	Windows XP, Windows 2000 Professional [desktop apps only]
Minimum supported server	Windows 2000 Server [desktop apps only]
Target Platform	Windows
Header	gdipluspath.h (include Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll