Функция GetUpdateRect (winuser.h)
Функция GetUpdateRect извлекает координаты наименьшего прямоугольника, полностью включающего область обновления указанного окна. GetUpdateRect извлекает прямоугольник в логических координатах. Если области обновления нет, GetUpdateRect извлекает пустой прямоугольник (устанавливает все координаты равными нулю).
Синтаксис
BOOL GetUpdateRect(
[in] HWND hWnd,
[out] LPRECT lpRect,
[in] BOOL bErase
);
Параметры
[in] hWnd
Дескриптор окна, область обновления которого должна быть извлечена.
[out] lpRect
Указатель на структуру RECT , которая получает координаты в единицах устройства включающего прямоугольника.
Приложение может задать для этого параметра значение NULL , чтобы определить, существует ли регион обновления для окна. Если этот параметр имеет значение NULL, GetUpdateRect возвращает ненулевое значение, если область обновления существует, и ноль, если она не имеет значения. Это обеспечивает простое и эффективное средство определения того, является ли сообщение WM_PAINT результатом недопустимой области.
[in] bErase
Указывает, следует ли стереть фон в области обновления. Если этот параметр имеет значение TRUE и область обновления не пуста, GetUpdateRect отправляет WM_ERASEBKGND сообщение в указанное окно для удаления фона.
Возвращаемое значение
Если область обновления не пуста, возвращаемое значение не равно нулю.
Если регион обновления отсутствует, возвращаемое значение равно нулю.
Комментарии
Прямоугольник обновления, полученный функцией BeginPaint , идентичен прямоугольнику, полученному с помощью GetUpdateRect.
BeginPaint автоматически проверяет регион обновления, поэтому любой вызов GetUpdateRect , выполненный сразу после вызова 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) |