Метод GraphicsPath::GetPathData (gdipluspath.h)

Статья
08/24/2023

Метод GraphicsPath::GetPathData получает массив точек и массив типов точек из этого пути. Вместе эти два массива определяют линии, кривые, фигуры и маркеры этого пути.

Синтаксис

Status GetPathData(
  [out] PathData *pathData
);

Параметры

[out] pathData

Тип: PathData*

Указатель на объект PathData , который получает данные пути. Элемент данных Points объекта PathData получает указатель на массив объектов PointF , содержащий точки пути. Элемент данных Types объекта PathData получает указатель на массив байтов, содержащий типы точек. Элемент данных Count объекта PathData получает целое число, указывающее количество элементов в массиве Points .

Возвращаемое значение

Тип: Состояние

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления 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
Header	gdipluspath.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll