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

Статья
03/13/2024

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

Синтаксис

BOOL ValidateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn
);

Параметры

[in] hWnd

Дескриптор окна, область обновления которого требуется изменить.

[in] hRgn

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

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

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

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

Функция BeginPaint автоматически проверяет всю клиентную область. Ни функция ValidateRect, ни ValidateRgn не должны вызываться, если часть области обновления должна быть проверена перед созданием следующего сообщения 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)