Русский справочник по Win32 API, Сорока Тарас

Русский справочник по Win32 API

на обложку

Сорока Тарас

Шрифт:

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

В случае успеха возвращается ненулевое значение.

В случае неудачи возвращается нуль.

См. также

FillRgn, PaintRgn .

GetPolyFillMode

Функция GetPolyFillMode извлекает текущий режим заполнения прямоугольника.

int GetPolyFillMode (

HDC hdc //

дескриптор контекста устройства

);

Параметры

hdc– идентифицирует контекст устройства.

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

В случае успеха возвращается режим заполнения прямоугольников, который может быть одним из следующих значений:

Значение	Пояснение
ALTERNATE	Попеременный режим. Закрашиваются только те фрагменты внутренней области многоугольника, которые получаются путем соединения линий с нечетными номерами (1, 3, 5 и т. д.). Другие фрагменты внутренней области не закрашиваются.
WINDING	Сквозной. Windows закрашивает все внутренние области.

В случае неудачи возвращается нуль.

См. также

SetPolyFillMode .

GetRegionData

Функция GetRegionData заполняет указанный буфер данными, описывающими область. Эти данные включают в себя размеры прямоугольника, покрывающего область.

DWORD GetRegionData (

HRGN hRgn , // дескриптор области

DWORD dwCount , // размер буфера, содержащего данные области

LPRGNDATA lpRgnData // адрес буфера

);

Параметры

hRgn– идентифицирует область.

dwCount– определяет размер буфера, на который указывает значение параметра lpRgnData , в байтах.

lpRgnData– указывает на структуру типа RGNDATA , которая получает информацию. Если значение этого параметра равно NULL, то возвращаемое значение содержит число байт, необходимых для данных области.

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

Если вызов функции завершается успехом и значение dwCount определяет соответствующее количество байт, возвращается 1. Если значение dwCount слишком мало или значение lpRgnData равно NULL, возвращается требуемое количество байт.

В случае неудачи возвращается нуль.

Комментарии

Функция GetRegionData используется в паре с функцией ExtCreateRegion .

См. также

ExtCreateRegion, RGNDATA .

GetRgnBox

Функция GetRgnBox извлекает ограничивающий прямоугольник указанной области.

int GetRgnBox (

HRGN hrgn , // дескриптор области

LPRECT lprc // адрес структуры, которая получает

// ограничивающий прямоугольник

);

Параметры

hrgn– идентифицирует область.

lprc– указывает на структуру типа RECT , которая получает ограничивающий прямоугольник.

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

Возвращаемое значение показывает сложность результирующей области и может принимать одно из следующих значений:

Значение	Пояснение
COMPLEXREGION	Область состоит более чем из одного прямоугольника.
ERROR	Произошла ошибка.
NULLREGION	Пустая область.
SIMPLEREGION	Область является одиночным прямоугольником.