Функция GetUpdateRect (winuser.h)

Статья
03/15/2023

Функция 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 сообщение в указанное окно для удаления фона.

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

Если область обновления не пуста, возвращаемое значение не равно нулю.

Если регион обновления отсутствует, возвращаемое значение равно нулю.

Требования


Минимальная версия клиента	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)