Функция ValidateRgn (winuser.h)
Функция ValidateRgn проверяет клиентную область в регионе, удаляя регион из текущей области обновления указанного окна.
Синтаксис
BOOL ValidateRgn(
[in] HWND hWnd,
[in] HRGN hRgn
);
Параметры
[in] hWnd
Дескриптор окна, область обновления которого требуется изменить.
[in] hRgn
Дескриптор области, определяющей область, которая будет удалена из региона обновления. Если этот параметр имеет значение NULL, удаляется вся клиентская область.
Возвращаемое значение
Если функция выполняется успешно, возвращается ненулевое значение.
Если функция выполняется неудачно, возвращается нулевое значение.
Комментарии
Указанный регион должен быть создан функцией region. Предполагается, что координаты региона являются клиентскими.
Функция 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) |