Функция GetWindowRgnBox (winuser.h)

Статья
03/13/2024

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

Синтаксис

int GetWindowRgnBox(
  [in]  HWND   hWnd,
  [out] LPRECT lprc
);

Параметры

[in] hWnd

Дескриптор для окна.

[out] lprc

Указатель на структуру RECT , которая получает размеры прямоугольника в единицах устройства относительно левого верхнего угла окна.

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

Возвращаемое значение указывает тип области, которую получает функция. Может быть одним из указанных далее.

Значение	Значение
COMPLEXREGION	Область состоит из нескольких прямоугольников.
ОШИБКА	Указанное окно не имеет области или произошла ошибка при попытке вернуть регион.
NULLREGION	Область пуста.
SIMPLEREGION	Область представляет собой один прямоугольник.

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

Чтобы задать область окна, вызовите функцию SetWindowRgn .

Требования

Требование	Значение
Минимальная версия клиента	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-0 (представлено в Windows 8)