graphicsPath：：GetPathData 方法 (gdipluspath.h)

项目
02/29/2024

GraphicsPath：：GetPathData 方法从此路径获取点数组和点类型数组。这两个数组一起定义此路径的线条、曲线、图形和标记。

语法

Status GetPathData(
  [out] PathData *pathData
);

参数

[out] pathData

类型： PathData*

指向接收路径数据的 PathData 对象的指针。 PathData 对象的 Points 数据成员接收指向包含路径点的 PointF 对象数组的指针。 PathData 对象的 Types 数据成员接收指向包含点类型的字节数组的指针。 PathData 对象的 Count 数据成员接收一个整数，该整数指示 Points 数组中的元素数。

返回值

类型：状态

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

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

注解

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

无需为点数组或类型的数组分配或解除分配内存。 GraphicsPath：：GetPathData 方法为数组分配内存， (返回的点和类型) 。 PathData 析构函数解除分配这些数组的内存。

示例

以下示例创建并绘制一个包含线条、矩形、椭圆形和曲线的路径。该代码通过将 PathData 对象的地址传递给 GraphicsPath：：GetPathData 方法来获取路径的点和类型。然后，代码绘制路径的每个数据点。

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

   // Create a path that has a line, a rectangle, an ellipse, and a curve.
   GraphicsPath path;
   
   PointF points[] = {
      PointF(200, 200),
      PointF(250, 240),
      PointF(200, 300),
      PointF(300, 310),
      PointF(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 data.
   PathData pathData;
   path.GetPathData(&pathData);

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

要求

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