Функция ValidateRect

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

Синтаксис

BOOL ValidateRect(
  HWND hWnd,          // дескриптор окна
  CONST RECT *lpRect  // координаты действительного прямоугольника
);

Параметры

hWnd

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

lpRect

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

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

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

Если функция завершается ошибкой, возвращаемое значение - нуль.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

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

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

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисованияBeginPaint, InvalidateRect, InvalidateRgn, RECT, ValidateRgn, WM_PAINT

Размещение и совместимость ValidateRect

К 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 -
Замечания по платформе Не имеется

Назад в оглавление
На главную страницу
В оглавление справки

Hosted by uCoz