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)
程式庫	Gdiplus.lib
Dll	Gdiplus.dll