Функция GetUpdateRect

Функция GetUpdateRect извлекает координаты наименьшего прямоугольника, который полностью включает в себя обновляемый регион заданного окна. GetUpdateRect извлекает прямоугольник в логических координатах. Если нет никакого обновляемого региона, функция GetUpdateRect извлекает пустой прямоугольник (устанавливает все координаты в нуль).

Синтаксис

BOOL GetUpdateRect(
  HWND hWnd,       // дескриптор окна
  LPRECT lpRect,   // координаты прямоугольника обновления
  BOOL bErase      // состояние очистки
);

Параметры

hWnd

[in] Дескриптор окна, обновляемый регион которого должен извлечься.

lpRect

[out] Указатель на структуру RECT, которая получает координаты, в единицах устройства, прямоугольника включения.

Приложение может установить эти параметры в NULL, чтобы определить, существует ли обновляемый регион для окна. Если этот параметр - NULL, функция GetUpdateRect возвращает не нуль, если обновляемый регион существует, и нуль, если его нет. Это дает простое и эффективное средство определения, было ли сообщение WM_PAINT из недопустимой области.

bErase

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

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

Если обновляемый регион не пуст, возвращаемое значение - не нуль.

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

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

Замечания

Прямоугольник обновления, найденный функцией BeginPaint, идентичен найденному прямоугольнику GetUpdateRect.

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

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисования, BeginPaint, GetUpdateRgn, InvalidateRect, RECT, UpdateWindow, ValidateRect

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

К 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 и выше
е
р
Используемая библиотека Gdi32.lib
Используемая DLL -
Заголовочный файл
- объявлено в Wingdi.h
- включено в Windows.h
Unicode -
Замечания по платформе Не имеется

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

Hosted by uCoz