Функция GetWindowRgn получает копию региона окна. Регион окна устанавливается при помощи вызова функции SetWindowRgn. Регион окна определяет область в пределах окна, где система разрешает рисовать. Система не выводит данные на экран любой части окна, которая находится за пределами региона окна.
int GetWindowRgn( HWND hWnd, // дескриптор окна HRGN hRgn // дескриптор региона окна );
|
[in] Дескриптор окна, регион которого должен быть получен.
hRgn[in] Дескриптор региона, который должен быть модифицирован, чтобы представить регион окна.
Возвращаемое значение указывает тип региона, который получает функция. Это может быть одно из ниже перечисленных значений.
Значение |
Предназначение |
---|---|
NULLREGION | Регион пуст. |
SIMPLEREGION | Регион - отдельный прямоугольник. |
COMPLEXREGION | Регион - более чем один прямоугольник. |
ERROR | У заданного окна нет региона или произошла ошибка в ходе попытки возвратить регион. |
Координаты региона окна относительно левого верхнего угла окна нерабочей области окна.
Чтобы установить регион окна, вызовите функцию SetWindowRgn.
Нижеследующий код выводит на экран, как Вы передаете дескриптор существующего региона.
HRGN hrgn = CreateRectRgn(0,0,0,0); int regionType = GetWindowRgn(hwnd, hrgn); if (regionType != ERROR) { /* hrgn содержит регион окна */ } DeleteObject(hrgn); /* законченный регион */ |
Обзор Окрашивание и рисование, Функции окрашивания и рисования, SetWindowRgn
Размещение и совместимость GetWindowRgn |
||
К | Windows Vista | Да |
л | Windows XP | Да |
и | Windows 2000 Professional | Да |
е | Windows NT Workstation | Да версии 3.51 и выше |
н | Windows Me | Да |
т | Windows 98 | Да |
Windows 95 | Да | |
С | Windows Server 2008 | Да |
е | Windows Server 2003 | Да |
р | Windows 2000 Server | Да |
в | Windows NT Server | Да версии 3.51 и выше |
е | ||
р | ||
Используемая библиотека | User32.lib | |
Используемая DLL | - | |
Заголовочный файл | ||
- объявлено в | Winuser.h | |
- включено в | Windows.h | |
Unicode | - | |
Замечания по платформе | Не имеется |