GraphicsPath::GetPathData 메서드(gdipluspath.h)

아티클
02/26/2024

GraphicsPath::GetPathData 메서드는 이 경로에서 점 배열과 점 형식의 배열을 가져옵니다. 이 두 배열은 함께 이 경로의 선, 곡선, 그림 및 표식을 정의합니다.

구문

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 포함)
라이브러리	Gdiplus.lib
DLL	Gdiplus.dll