Функция ValidateRgn проверяет достоверность рабочей области внутри региона, исключая регион из текущего региона обновления заданного окна.
BOOL ValidateRgn( HWND hWnd, // дескриптор окна HRGN hRgn // дескриптор региона ); |
[in] Дескриптор окна, регион обновления которого должен быть модифицирован.
hRgn[in] Дескриптор региона, определяющего область, которая будет исключена из региона обновления. Если этот параметр - NULL, вся рабочая область исключается.
Если функция завершается успешно, возвращаемое значение - не нуль.
Если функция завершается ошибкой, возвращаемое значение - нуль.
Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.
Заданный регион должен создаваться функцией региона. Предполагается, что координаты региона - координаты рабочей области.
Функция BeginPaint автоматически проверяет достоверность всей рабочей области. Ни функция ValidateRect, ни функция ValidateRgn не должны вызываться, если у части региона обновления должна быть проверена достоверность, перед тем, как будет сгенерировано следующее сообщение WM_PAINT.
Обзор Окрашивание и рисование, Функции окрашивания и рисования, BeginPaint, ExcludeUpdateRgn, InvalidateRect, InvalidateRgn, ValidateRect, WM_PAINT
Размещение и совместимость ValidateRgn |
||
| К | Windows Vista | Да |
| л | Windows XP | Да |
| и | Windows 2000 Professional | Да |
| е | Windows NT Workstation | Да версии 3.1 и выше |
| н | Windows Me | Да |
| т | Windows 98 | Да |
| Windows 95 | Да | |
| С | Windows Server 2008 | Да |
| е | Windows Server 2003 | Да |
| р | Windows 2000 Server | Да |
| в | Windows NT Server | Да версии 3.1 и выше |
| е | ||
| р | ||
| Используемая библиотека | User32.lib | |
| Используемая DLL | - | |
| Заголовочный файл | ||
| - объявлено в | Winuser.h | |
| - включено в | Windows.h | |
| Unicode | - | |
| Замечания по платформе | Не имеется | |