Функция GetUpdateRgn извлекает обновляемый регион окна, копируя его в заданный регион. Координаты обновляемого региона исчисляются относительно левого верхнего угла окна (то есть, они - координаты рабочей области).
int GetUpdateRgn( HWND hWnd, // дескриптор окна HRGN hRgn, // дескриптор региона BOOL bErase // состояние очистки ); |
hWnd
[in] Дескриптор окна с обновляемым регионом, который должен извлечься.hRgn
[in] Дескриптор региона, который получает обновляемый регион.bErase
[in] Определяет, должен ли фон окна быть стерт и должны ли нерабочие области дочерних окон рисоваться. Если этот параметр - FALSE, никакого рисования не делается.
Возвращаемое значение указывает степень сложности получающегося региона; это может быть одно из ниже перечисленных значений
Значение |
Предназначение |
|---|---|
| COMPLEXREGION | Регион состоит из более чем одного прямоугольника. |
| ERROR | Произошла ошибка. |
| NULLREGION | Регион пуст. |
| SIMPLEREGION | Регион - отдельный прямоугольник. |
Функция BeginPaint автоматически проверяет достоверность обновляемого региона, так что любой вызов в GetUpdateRgn, сделанный немедленно после того, как был вызов BeginPaint, извлекает пустой обновляемый регион.
Обзор Окрашивание и рисование, Функции окрашивания и рисования
Размещение и совместимость GetUpdateRgn |
||
| К | Windows Vista | Да |
| л | Windows XP | Да |
| и | Windows 2000 Professional | Да |
| е | Windows NT Workstation | Да версии 3.1 и выше |
| н | Windows Me | Да |
| т | Windows 98 | Да |
| Windows 95 | Да | |
| С | Windows Server 2008 | Да |
| е | Windows Server 2003 | Да |
| р | Windows 2000 Server | Да |
| в | Windows NT Server | Да версии 3.1 и выше |
| е | ||
| р | ||
| Используемая библиотека | User32.lib | |
| Используемая DLL | - | |
| Заголовочный файл | ||
| - объявлено в | Winuser.h | |
| - включено в | Windows.h | |
| Unicode | - | |
| Замечания по платформе | Не имеется | |