GraphicsPath::GetPathData メソッド (gdipluspath.h)

[アーティクル]
02/27/2024

GraphicsPath::GetPathData メソッドは、このパスからポイントの配列とポイント型の配列を取得します。これら 2 つの配列を組み合わせて、このパスの線、曲線、図形、マーカーを定義します。

構文

Status GetPathData(
  [out] PathData *pathData
);

パラメーター

[out] pathData

型: PathData*

パスデータを受け取る PathData オブジェクトへのポインター。 PathData オブジェクトの Points データメンバーは、パスポイントを含む PointF オブジェクトの配列へのポインターを受け取ります。 PathData オブジェクトの Types データメンバーは、ポイント型を含むバイト配列へのポインターを受け取ります。 PathData オブジェクトの Count データメンバーは、Points 配列内の要素の数を示す整数を受け取ります。

戻り値

種類: 状態

メソッドが成功した場合は、 Status 列挙体の要素である Ok を返します。

メソッドが失敗した場合は、 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