GraphicsPathIterator::CopyData 方法 (gdipluspath.h)

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

另请参阅

构造并绘制轨迹

GetPathData

GetPathPoints 方法

GetPathTypes

GetPointCount

GraphicsPath

GraphicsPathIterator

GraphicsPathIterator::Enumerate

GraphicsPathIterator::GetCount

路径