Функция GetWindowRgn

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

Синтаксис

int GetWindowRgn(
  HWND hWnd, // дескриптор окна
  HRGN hRgn  // дескриптор региона окна
);

 

Параметры

hWnd

[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 -
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz