Функция SetWindowRgn устанавливает регион окна. Регион окна устанавливает область внутри окна, где система разрешает рисовать. Система не выводит на экран любую часть окна, которая находится за пределами региона окна.
int SetWindowRgn( HWND hWnd, // дескриптор окна HRGN hRgn, // дескриптор региона BOOL bRedraw // опции перерисовки окна ); |
[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 | - | |
Замечания по платформе | Не имеется |