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

Статья
03/04/2024

Функция CreatePolyPolygonRgn создает область, состоящую из ряда многоугольников. Многоугольник может перекрываться.

Синтаксис

HRGN CreatePolyPolygonRgn(
  [in] const POINT *pptl,
  [in] const INT   *pc,
  [in] int         cPoly,
  [in] int         iMode
);

Параметры

[in] pptl

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

[in] pc

Указатель на массив целых чисел, каждое из которых указывает количество точек в одном из многоугольников в массиве, на который указывает lppt.

[in] cPoly

Общее число целых чисел в массиве, на который указывает lpPolyCounts.

[in] iMode

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

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

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

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

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

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

Требования

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