Поделиться через

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

  • Статья

Функция GetWindowRgn получает копию области окна. Область окна задается путем вызова функции SetWindowRgn . Область окна определяет область в окне, в которой система разрешает рисование. Система не отображает ни одну часть окна, расположенную за пределами области окна

Синтаксис

int GetWindowRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

Параметры

[in] hWnd

Дескриптор к окну, область окна которого требуется получить.

[in] hRgn

Дескриптор области, которая будет изменена для представления области окна.

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

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

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

Комментарии

Координаты области окна относятся к верхнему левому углу окна, а не к клиентской области окна.

Чтобы задать область окна, вызовите функцию 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)

См. также раздел

Функции рисования и рисования

Общие сведения о рисовании и рисовании

SetWindowRgn