Функция GetWindowRgn получает копию региона окна. Регион окна устанавливается при помощи вызова функции SetWindowRgn. Регион окна определяет область в пределах окна, где система разрешает рисовать. Система не выводит данные на экран любой части окна, которая находится за пределами региона окна.
int GetWindowRgn( HWND hWnd, // дескриптор окна HRGN hRgn // дескриптор региона окна );
|
[in] Дескриптор окна, регион которого должен быть получен.
hRgn[in] Дескриптор региона, который должен быть модифицирован, чтобы представить регион окна.
Возвращаемое значение указывает тип региона, который получает функция. Это может быть одно из ниже перечисленных значений.
Значение |
Предназначение |
|---|---|
| NULLREGION | Регион пуст. |
| SIMPLEREGION | Регион - отдельный прямоугольник. |
| COMPLEXREGION | Регион - более чем один прямоугольник. |
| ERROR | У заданного окна нет региона или произошла ошибка в ходе попытки возвратить регион. |
Координаты региона окна относительно левого верхнего угла окна нерабочей области окна.
Чтобы установить регион окна, вызовите функцию SetWindowRgn.
Нижеследующий код выводит на экран, как Вы передаете дескриптор существующего региона.
|
Обзор Окрашивание и рисование, Функции окрашивания и рисования, 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 | - | |
| Замечания по платформе | Не имеется | |