Поделиться через


Метод GraphicsPath::AddPolygon(constPoint*,INT) (gdipluspath.h)

Метод GraphicsPath::AddPolygon добавляет к этому пути многоугольник.

Синтаксис

Status AddPolygon(
  [in] const Point *points,
  [in] INT         count
);

Параметры

[in] points

Тип: const Point*

Указатель на массив точек, указывающий вершины многоугольника.

[in] count

Тип: INT

Целое число, указывающее количество элементов в массиве точек .

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

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

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

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

Комментарии

Метод GraphicsPath::AddPolygon аналогичен методу AddLines . Разница заключается в том, что многоугольник является внутренне закрытой фигурой, но последовательность линий не является закрытой фигурой, если не вызвать GraphicsPath::CloseFigure. Когда Windows GDI+ отрисовывает путь, каждый многоугольник в этом пути закрывается; то есть последняя вершина многоугольника соединена с первой вершиной прямой линией.

Примеры

В следующем примере создается путь к объекту GraphicsPath, добавляется многоугольник в путь, а затем рисуется путь.

VOID Example_AddPolygon(HDC hdc)
{
   Graphics graphics(hdc); 
 
   Point pts[] = {Point(20, 20),
                  Point(120, 20),
                  Point(120, 70)};

   GraphicsPath path;
   path.AddPolygon(pts, 3);

   // Draw the path.
   Pen pen(Color(255, 255, 0, 0));
   graphics.DrawPath(&pen, &path);
}

Требования

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

См. также раздел

Методы AddPolygon

Обрезка с помощью региона

Построение и рисование контуров

Создание градиента пути

GraphicsPath

Пути

Point

Полигоны