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

Статья
03/05/2024

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

Синтаксис

Status AddPolygon(
  const PointF *points,
  INT          count
);

Параметры

points

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

count

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

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

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

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

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

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

Примеры

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

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

   PointF pts[] = {PointF(20.0f, 20.0f),
                   PointF(120.0f, 20.0f),
                   PointF(120.0f, 70.0f)};

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

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