Примечание.
Для доступа к этой странице требуется авторизация. Вы можете попробовать войти или изменить каталоги.
Для доступа к этой странице требуется авторизация. Вы можете попробовать изменить каталоги.
Функция GetUpdateRgn извлекает область обновления окна, копируя ее в указанную область. Координаты области обновления относятся к левому верхнему углу окна (т. е. клиентские координаты).
Синтаксис
int GetUpdateRgn(
[in] HWND hWnd,
[in] HRGN hRgn,
[in] BOOL bErase
);
Параметры
[in] hWnd
Дескриптор в окне с регионом обновления, который требуется извлечь.
[in] hRgn
Дескриптор в регионе для получения региона обновления.
[in] bErase
Указывает, следует ли стереть фон окна и следует ли отрисовыть неклиентные области дочерних окон. Если этот параметр имеет значение FALSE, рисование не выполняется.
Возвращаемое значение
Возвращаемое значение указывает на сложность результирующей области; Это может быть одно из следующих значений.
| Значение | Значение |
|---|---|
| COMPLEXREGION | Область состоит из нескольких прямоугольников. |
| ОШИБКА | Произошла ошибка. |
| NULLREGION | Область пуста. |
| SIMPLEREGION | Область представляет собой один прямоугольник. |
Комментарии
Функция BeginPaint автоматически проверяет область обновления, поэтому любой вызов GetUpdateRgn , выполненный сразу после вызова BeginPaint , извлекает пустую область обновления.
Требования
| Минимальная версия клиента | 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-0 (появилось в Windows 8) |