Значение
|
Пояснение
|
COMPLEXREGION
|
Область состоит более чем из одного прямоугольника.
|
ERROR
|
Произошла ошибка.
|
NULLREGION
|
Пустая область.
|
SIMPLEREGION
|
Область является одиночным прямоугольником.
|
Комментарии
Текущая область отсечения контекста устройства определяется пересечением его области отсечения и его метаобласти.
Функция SetMetaRgnдолжна вызываться только после того, как исходный контекст устройства приложения был сохранен функцией SaveDC.
См. также
GetMetaRgn, SaveDC.
Функция GetWindowRgnполучает копию оконной области окна. Оконная область окна устанавливается вызовом функции SetWindowRgn. Оконная область определяет участок внутри окна, в котором операционная система выполняет рисование. Операционная система не отображает части окна, лежащие вне оконной области.
int GetWindowRgn(
HWND hWnd , // дескриптор окна. чья оконная область извлекается функцией
HRGN hRgn // дескриптор области, которая получает копию
// оконной области
);
Параметры
hWnd - дескриптор окна, оконная область которого извлекается.
hrgn - дескриптор области. Эта область получает копию оконной области.
Возвращаемые значения
В случае успеха возвращаемое значение определяет сложность области и может быть одним из предопределенных значений:
Значение
|
Пояснение
|
COMPLEXREGION
|
Область состоит более чем из одного прямоугольника.
|
ERROR
|
Произошла ошибка.
|
NULLREGION
|
Пустая область.
|
SIMPLEREGION
|
Область является одиночным прямоугольником.
|
Комментарии
Координаты оконной области окна относительны верхнего левого угла окна, а не клиентской области окна.
Для установки оконной области окна используйте функцию SetWindowRgn.
См. также
SetWindowRgn.
Функция 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обновляет клиентскую область указанного окна, отправляя ему сообщение WM _ PAINT, если область обновления ( update region ) окна не пуста. Функция отправляет сообщение WM _ PAINT напрямую оконной процедуре указанного окна, обходя очередь сообщений приложения. Если область обновления пуста, то сообщение не отправляется.
BOOL UpdateWindow(
HWND hWnd // дескриптор окна
);
Параметры
hWnd - идентифицирует обновляемое окно.
Возвращаемые значения
В случае успеха возвращается ненулевое значение.
В случае неудачи возвращается нуль.
См. также
ExcludeUpdateRgn, GetUpdateRect, GetUpdateRgn, InvalidateRect, InvalidateRgn, WM_PAINT.
Функция-ловушка ( hook procedure ) ForegroundIdleProcявляется определяемой приложением функцией обратного вызова, которую вызывает система каждый раз, когда 32-битный поток переднего плана намеревается стать неактивным.
DWORD ForegroundIdleProc(
int code , // код хука
DWORD wParam , // не используется
LONG lParam // не используется
Читать дальше