Функция CreatePolygonRgn (wingdi.h)

Статья
03/08/2023

Функция CreatePolygonRgn создает многоугольную область.

Синтаксис

HRGN CreatePolygonRgn(
  [in] const POINT *pptl,
  [in] int         cPoint,
  [in] int         iMode
);

Параметры

[in] pptl

Указатель на массив структур POINT , определяющих вершины многоугольника в логических единицах. Предполагается, что многоугольник закрыт. Каждую вершину можно указать только один раз.

[in] cPoint

Количество точек в массиве.

[in] iMode

Режим заполнения, используемый для определения пикселей в области. Этот параметр может принимать одно из указанных ниже значений.

Значение	Значение
АЛЬТЕРНАТИВНЫЕ	Выбирает альтернативный режим (заполняет область между нечетными и четными сторонами многоугольников на каждой линии сканирования).
ОБМОТКИ	Выбирает режим обмотки (заполняет любую область ненулевым значением обмотки).

Дополнительные сведения об этих режимах см. в разделе Функция SetPolyFillMode .

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

Если функция выполнена успешно, возвращаемое значение будет дескриптором области.

Если функция завершается сбоем, возвращается значение NULL.

Области, созданные методами Rgn Create<shape>(например , CreateRectRgn и CreatePolygonRgn), включают только внутреннюю часть фигуры; контур фигуры исключается из области. Это означает, что любая точка на линии между двумя последовательными вершинами не включается в область . Если бы вы вызвали PtInRegion для такой точки, он возвратит ноль в качестве результата.

Требования


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