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

Статья
07/16/2024

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

Синтаксис

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

Параметры

points

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

count

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

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

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

Если метод выполнен успешно, он возвращает ok, который является элементом перечисления 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);
}