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

является одиночным прямоугольником.

Комментарии

Используется только копия выбранной области. Сама область может быть выбрана для любого числа контекстов устройства или может быть удалена.

Функция SelectClipRgn полагает, что координаты для области являются координатами устройства.

Для удаления области отсечения контекста устройства, укажите в качестве дескриптора области NULL .

См. также

ExtSelectClipRgn .

SetMetaRgn

Функция SetMetaRgn пересекает текущую область отсечения для указанного контекста устройства с текущей метаобластью и сохраняет объединенную область как новую метаобласть для указанного контекста устройства. Область отсечения сбрасывается в нулевую область.

int SetMetaRgn (

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

);

Параметры

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

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

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

Значение

Пояснение

COMPLEXREGION

Область состоит более чем из одного прямоугольника.

ERROR

Произошла ошибка.

NULLREGION

Пустая область.

SIMPLEREGION

Область является одиночным прямоугольником.

Комментарии

Текущая область отсечения контекста устройства определяется пересечением его области отсечения и его метаобласти.

Функция SetMetaRgn должна вызываться только после того, как исходный контекст устройства приложения был сохранен функцией SaveDC .

См. также

GetMetaRgn, SaveDC .

Рисование

GetWindowRgn

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

int GetWindowRgn (

HWND hWnd , // дескриптор окна. чья оконная область извлекается функцией

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

// оконной области

);

Параметры

hWnd - дескриптор окна, оконная область которого извлекается.

hrgn - дескриптор области. Эта область получает копию оконной области.

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

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

Значение

Пояснение

COMPLEXREGION

Область состоит более чем из одного прямоугольника.

ERROR

Произошла ошибка.

NULLREGION

Пустая область.

SIMPLEREGION

Область является одиночным прямоугольником.

Комментарии

Координаты оконной области окна относительны верхнего левого угла окна, а не клиентской области окна.

Для установки оконной области окна используйте функцию SetWindowRgn .

См. также

SetWindowRgn .

SetRectRgn

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

BOOL SetRectRgn (

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

int nLeftRect , // x -координата верхнего левого угла прямоугольника

int nTopRect , // y -координата верхнего левого угла прямоугольника

int nRightRect , // x -координата нижнего правого угла прямоугольника

int nBottomRect // y -координата нижнего правого угла прямоугольника

);

Параметры

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

nLeftRect - определяет x -координату верхнего левого угла прямоугольной области.

nTopRect - определяет y -координату верхнего левого угла прямоугольной области.

nRightRect - определяет x -координату нижнего правого угла прямоугольника.

nBottomRect - определяет y -координату нижнего правого угла прямоугольника.

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

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

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

Комментарии

Область не включает в себя нижнюю и правую границы прямоугольника.

См. также

CreateRectRgn .

UpdateWindow

Функция UpdateWindow обновляет клиентскую область указанного окна, отправляя ему сообщение WM _ PAINT, если область обновления ( update region ) окна не пуста. Функция отправляет сообщение WM _ PAINT напрямую оконной процедуре указанного окна, обходя очередь сообщений приложения. Если область обновления пуста, то сообщение не отправляется.

BOOL UpdateWindow (

HWND hWnd // дескриптор окна

);

--">