Функция SetWindowRgn

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

Синтаксис

int SetWindowRgn(
  HWND hWnd,     // дескриптор окна
  HRGN hRgn,     // дескриптор региона
  BOOL bRedraw   // опции перерисовки окна
);

Параметры

hWnd

[in] Дескриптор окна, регион окна которого должен быть установлен.

hRgn

[in] Дескриптор региона. Функция устанавливает регион окна в окне для этого региона.

Если hRgn - NULL, функция устанавливает регион окна в NULL.

bRedraw

[in] Определяет, перерисовывает ли система окно после установки региона окна. Если параметр bRedraw - TRUE, система делает это так; в противном случае она этого не делает. Как правило, Вы устанавливаете bRedraw в TRUE, если окно видимо.

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

Если функция завершается успешно, возвращаемое значение - не нуль.

Если функция завершается ошибкой, возвращаемое значение - нуль.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Когда эта функция вызвана, система отправляет сообщения WM_WINDOWPOSCHANGING и WM_WINDOWPOSCHANGED окну.

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

После успешного вызова функции SetWindowRgn системе принадлежит регион, определенный дескриптором hRgn региона. Система не делает копию региона. Таким образом, Вы не должны делать дополнительные вызовы функции с этим дескриптором региона. В частности не удаляйте этот дескриптор региона. Система удаляет дескриптор региона  тогда, когда он больше не нужен.

Чтобы получить окно региона окна, вызовите функцию GetWindowRgn.

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисования, GetWindowRgn, WM_WINDOWPOSCHANGING, WM_WINDOWPOSCHANGED

Размещение и совместимость SetWindowRgn

К 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