GraphicsPathIterator：：Enumerate 方法 (gdipluspath.h)

项目
02/29/2024

GraphicsPathIterator：：Enumerate 方法将路径的数据点复制到 PointF 数组，并将路径的点类型复制到 BYTE 数组。

语法

INT Enumerate(
  [out] PointF *points,
  [out] BYTE   *types,
  [in]  INT    count
);

参数

[out] points

类型： PointF*

指向接收路径的数据点的数组的指针。

[out] types

类型： BYTE*

指向接收路径点类型的数组的指针。

[in] count

类型： INT

指定点数组中的元素数的整数。这与类型数组中的元素数相同。

返回值

类型： INT

此方法返回检索的点数。

注解

此 GraphicsPathIterator 对象与 GraphicsPath 对象相关联。该 GraphicsPath 对象具有点数组和类型数组。类型数组中的每个元素都是一个字节，用于指定点类型和点数组中相应元素的一组标志。 PathPointType 枚举中列出了可能的点类型和标志。

可以调用 GraphicsPathIterator：：GetCount 方法来确定路径中的数据点数。 points 参数指向接收数据点的缓冲区，类型参数指向接收类型的缓冲区。在调用 GraphicsPathIterator：：Enumerate 方法之前，必须为这些缓冲区分配内存。点缓冲区的大小应为 GraphicsPathIterator：：GetCount 的返回值乘以 size of (PointF) 。类型缓冲区的大小应为 GraphicsPathIterator：：GetCount 的返回值。

示例

以下示例创建一个 GraphicsPath 对象，并向该路径添加三行。该代码创建一个 GraphicsPathIterator 对象，并调用其 GraphicsPathIterator：：Enumerate 方法来检索路径的数据点和点类型。然后，代码显示 GraphicsPathIterator：：Enumerate 方法返回的计数。


#define BUFFER_SIZE 30
TCHAR numPointsEnum[BUFFER_SIZE];

// Add some lines to a path.
Point pts[] = {Point(20, 20), 
                Point(100, 20), 
                Point(100, 50), 
                Point(20, 50)};
GraphicsPath path;
path.AddLines(pts, 4);

// Create a GraphicsPathIterator object, and associate it with the path.
GraphicsPathIterator pathIterator(&path);

// Create destination arrays, and copy the path data to them.
UINT c = pathIterator.GetCount();
PointF* pEnumPoints = new PointF[c]; 
BYTE* pTypes = new BYTE[c];
INT count = pathIterator.Enumerate(pEnumPoints, pTypes, c);

// Confirm that the points were enumerated.
StringCchPrintf(
   numPointsEnum, BUFFER_SIZE, TEXT("%d points were enumerated."), count);

MessageBox(hWnd, numPointsEnum, TEXT("Enumerate"), NULL);

delete[] pEnumPoints;
delete[] pTypes;

要求

要求	值
最低受支持的客户端	Windows XP、Windows 2000 Professional [仅限桌面应用]
最低受支持的服务器	Windows 2000 Server [仅限桌面应用]
目标平台	Windows
标头	gdipluspath.h (包括 Gdiplus.h)
Library	Gdiplus.lib
DLL	Gdiplus.dll