GraphicsPath：：GetPathData 方法 (gdipluspath.h)

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);
   }
}

規格需求

另請參閱

使用區域裁剪

建構和繪製路徑

建立路徑漸層

GetPathPoints 方法

GraphicsPath

GraphicsPath：：GetPathTypes

GraphicsPath：：GetPointCount

PathData

PathPointType

路徑

PointF