Функция GetUpdateRect извлекает координаты наименьшего прямоугольника, который полностью включает в себя обновляемый регион заданного окна. GetUpdateRect извлекает прямоугольник в логических координатах. Если нет никакого обновляемого региона, функция GetUpdateRect извлекает пустой прямоугольник (устанавливает все координаты в нуль).
BOOL GetUpdateRect( HWND hWnd, // дескриптор окна LPRECT lpRect, // координаты прямоугольника обновления BOOL bErase // состояние очистки ); |
[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 | - | |
| Замечания по платформе | Не имеется | |