Метод GraphicsPath::GetPathPoints(Point*,INT) (gdipluspath.h)

Статья
08/24/2023

Метод GraphicsPath::GetPathPoints получает массив точек этого пути. Массив содержит конечные точки и контрольные точки линий и сплайнов Безье, которые используются для рисования пути.

Синтаксис

Status GetPathPoints(
  [out] Point *points,
  [in]  INT   count
);

Параметры

[out] points

Тип: Point*

Указатель на массив объектов Point , которые получают точки данных. Для этого массива необходимо выделить память. Чтобы определить требуемый размер массива, можно вызвать метод GraphicsPath::GetPointCount . Размер в байтах должен быть возвращаемым значением GraphicsPath::GetPointCount , умноженным на sizeof(Point).

[in] count

Тип: INT

Целое число, указывающее количество элементов в массиве точек . Задайте для этого параметра значение, возвращаемое методом GraphicsPath::GetPointCount .

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

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

В случае успешного выполнения метода возвращается ОК, который является элементом перечисления Status .

Если метод завершается ошибкой, он возвращает один из других элементов перечисления Status .

Объект GraphicsPath имеет массив точек и массив типов. Каждый элемент в массиве типов представляет собой байт, указывающий тип точки и набор флагов для соответствующего элемента в массиве точек. Возможные типы точек и флаги перечислены в перечислении PathPointType .

Примеры

В следующем примере создается и рисуется путь с линией, прямоугольником, эллипсом и кривой. Код вызывает метод GraphicsPath::GetPointCount пути, чтобы определить количество точек данных, хранящихся в пути. Код выделяет буфер, достаточно большой для получения массива точек данных, и передает адрес этого буфера методу GraphicsPath::GetPathPoints . Наконец, код рисует каждую точку данных пути.

VOID GetPathPointsExample(HDC hdc)
{
   Graphics graphics(hdc);

   // Create a path that has a line, a rectangle, an ellipse, and a curve.
   GraphicsPath path;

   Point points[] = {
      Point(200, 200),
      Point(250, 240),
      Point(200, 300),
      Point(300, 310),
      Point(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 points.
   INT count = path.GetPointCount();
   Point* dataPoints = new Point[count];
   path.GetPathPoints(dataPoints, count);

   // Draw the path's data points.
   SolidBrush brush(Color(255, 255, 0, 0));
   for(INT j = 0; j < count; ++j)
   {
      graphics.FillEllipse(
         &brush, 
         dataPoints[j].X - 3.0f, 
         dataPoints[j].Y - 3.0f,
         6.0f,
         6.0f);
   }
   delete [] dataPoints; 
}
Color(255, 255, 0,  0)

Требования


Минимальная версия клиента	Windows XP, Windows 2000 Профессиональная [только классические приложения]
Минимальная версия сервера	Windows 2000 Server [только классические приложения]
Целевая платформа	Windows
Header	gdipluspath.h (включая Gdiplus.h)
Библиотека	Gdiplus.lib
DLL	Gdiplus.dll