Функция GetWindowRgn (winuser.h)
Функция GetWindowRgn получает копию области окна. Область окна задается путем вызова функции SetWindowRgn . Область окна определяет область в окне, в которой система разрешает рисование. Система не отображает ни одну часть окна, расположенную за пределами области окна
Синтаксис
int GetWindowRgn(
[in] HWND hWnd,
[in] HRGN hRgn
);
Параметры
[in] hWnd
Дескриптор к окну, область окна которого требуется получить.
[in] hRgn
Дескриптор области, которая будет изменена для представления области окна.
Возвращаемое значение
Возвращаемое значение указывает тип области, которую получает функция. Может быть одним из указанных далее.
| Код возврата | Описание |
|---|---|
|
Область пуста. |
|
Область представляет собой один прямоугольник. |
|
Область состоит из нескольких прямоугольников. |
|
Указанное окно не имеет области или произошла ошибка при попытке вернуть регион. |
Комментарии
Координаты области окна относятся к верхнему левому углу окна, а не к клиентской области окна.
Чтобы задать область окна, вызовите функцию SetWindowRgn .
Примеры
В следующем коде показано, как передать дескриптор существующего региона.
HRGN hrgn = CreateRectRgn(0,0,0,0);
int regionType = GetWindowRgn(hwnd, hrgn);
if (regionType != ERROR)
{
/* hrgn contains window region */
}
DeleteObject(hrgn); /* finished with region */
Требования
| Минимальная версия клиента | Windows 2000 Professional [только классические приложения] |
| Минимальная версия сервера | Windows 2000 Server [только классические приложения] |
| Целевая платформа | Windows |
| Header | winuser.h (включая Windows.h) |
| Библиотека | User32.lib |
| DLL | User32.dll |
| Набор API | ext-ms-win-ntuser-draw-l1-1-2 (появилась в Windows 10 версии 10.0.10240) |