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

Статья
08/28/2023

Функция ValidateRect проверяет клиентную область в прямоугольнике, удаляя прямоугольник из области обновления указанного окна.

Синтаксис

BOOL ValidateRect(
  [in] HWND       hWnd,
  [in] const RECT *lpRect
);

Параметры

[in] hWnd

Дескриптор к окну, область обновления которого требуется изменить. Если этот параметр имеет значение NULL, система делает недействительными и перерисовывает все окна и отправляет сообщения WM_ERASEBKGND и WM_NCPAINT в процедуру окна перед возвратом функции.

[in] lpRect

Указатель на структуру RECT , содержащую клиентские координаты прямоугольника, удаляемого из области обновления. Если этот параметр имеет значение NULL, удаляется вся клиентская область.

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

Если функция выполняется успешно, возвращается ненулевое значение.

Если функция выполняется неудачно, возвращается нулевое значение.

Функция BeginPaint автоматически проверяет всю клиентную область. Не следует вызывать функцию ValidateRect или ValidateRgn , если часть области обновления должна быть проверена до создания следующего сообщения WM_PAINT .

Система продолжает создавать сообщения WM_PAINT до тех пор, пока не будет проверен текущий регион обновления.

Требования


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