GraphicsPathIterator：：CopyData 方法 (gdipluspath.h)

项目
02/26/2024

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

语法

INT CopyData(
  [out] PointF *points,
  [out] BYTE   *types,
  [in]  INT    startIndex,
  [in]  INT    endIndex
);

参数

[out] points

类型： PointF*

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

[out] types

类型： BYTE*

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

[in] startIndex

类型： INT

指定要复制的点和类型的起始索引的整数。

[in] endIndex

类型： INT

指定要复制的点和类型的结束索引的整数。

返回值

类型： INT

此方法返回复制的点数。这与复制的类型数相同。

注解

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

可以调用 GraphicsPathIterator：：GetCount 方法来确定路径中的数据点数。

示例

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


#define BUFFER_SIZE 30
TCHAR numPointsCopied[BUFFER_SIZE];

// Create the points for three lines in a path.
Point pts[] = { Point(20, 20), 
                Point(100, 20), 
                Point(100, 50), 
                Point(20, 50) };
GraphicsPath path;
path.AddLines(pts, 4); // Add the lines to the path.

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

// Create destination arrays, and copy the path data to them.
PointF* pCopiedPoints = new PointF[4]; 
BYTE* pTypes = new BYTE[4];
INT count = pathIterator.CopyData(pCopiedPoints, pTypes, 0, 3);

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

MessageBox(hWnd, numPointsCopied, TEXT("CopyData"), NULL);

delete[] pCopiedPoints;
delete[] pTypes;

要求

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