GraphicsPath：：GetPathPoints（Point*，INT）方法（gdipluspath.h）

项目
08/15/2024

GraphicsPath：：GetPathPoints 方法获取此路径的点数组。数组包含用于绘制路径的线条和 Bézier 样条的终结点和控制点。

语法

Status GetPathPoints(
  [out] Point *points,
  [in]  INT   count
);

参数

[out] points

类型：点*

指向接收数据点的点对象的数组的指针。必须为此数组分配内存。可以调用 GraphicsPath：：GetPointCount 方法来确定数组所需的大小。大小（以字节为单位）应为 GraphicsPath：：GetPointCount 乘以 sizeof（Point）的返回值。

[in] count

类型：INT

指定数组中点数的整数。将此参数设置为等于 GraphicsPath：：GetPointCount 方法的返回值。

返回值

类型：状态

如果方法成功，则返回 Ok，这是状态枚举的元素。

如果方法失败，它将返回状态枚举的其他元素之一。

言论

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

例子

以下示例创建并绘制具有线条、矩形、椭圆和曲线的路径。该代码调用路径的 GraphicsPath：：GetPointCount 方法来确定存储在路径中的数据点数。该代码分配足够大的缓冲区来接收数据点数组，并将该缓冲区的地址传递给 GraphicsPath：：GetPathPoints 方法。最后，代码绘制每个路径的数据点。

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

   // Create a path that has a line, a rectangle, an ellipse, and a curve.
   GraphicsPath path;

   Point points[] = {
      Point(200, 200),
      Point(250, 240),
      Point(200, 300),
      Point(300, 310),
      Point(250, 350)};

   path.AddLine(20, 100, 150, 200);
   path.AddRectangle(Rect(40, 30, 80, 60));
   path.AddEllipse(Rect(200, 30, 200, 100));
   path.AddCurve(points, 5);

   // Draw the path.
   Pen pen(Color(255, 0, 0, 255));
   graphics.DrawPath(&pen, &path);

   // Get the path points.
   INT count = path.GetPointCount();
   Point* dataPoints = new Point[count];
   path.GetPathPoints(dataPoints, count);

   // Draw the path's data points.
   SolidBrush brush(Color(255, 255, 0, 0));
   for(INT j = 0; j < count; ++j)
   {
      graphics.FillEllipse(
         &brush, 
         dataPoints[j].X - 3.0f, 
         dataPoints[j].Y - 3.0f,
         6.0f,
         6.0f);
   }
   delete [] dataPoints; 
}
Color(255, 255, 0,  0)

要求

要求	价值
最低支持的客户端	Windows XP，Windows 2000 Professional [仅限桌面应用]
支持的最低服务器	Windows 2000 Server [仅限桌面应用]
目标平台	窗户
标头	gdipluspath.h （包括 Gdiplus.h）
库	Gdiplus.lib
DLL	Gdiplus.dll