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


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

Функция 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 .

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

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

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

Комментарии

Если объект HRGN больше не нужен, вызовите функцию DeleteObject , чтобы удалить его.

Координаты области представлены в виде 27-разрядных целых чисел со знаком.

Требования

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

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

CreatePolygonRgn

CreateRectRgn

CreateRectRgnIndirect

CreateRoundRectRgn

DeleteObject

ExtCreateRegion

GetRegionData

ТОЧКИ

Функции регионов

Обзор регионов

SelectObject

SetPolyFillMode