CWnd::GetUpdateRect

Статья
02/20/2013

Возвращает координаты прямоугольника, который полностью наименьшего ограничивающий область обновления.

BOOL GetUpdateRect(
   LPRECT lpRect,
   BOOL bErase = FALSE 
);

Параметры

lpRect
Указывает на CRect объект или структура RECT, получать клиентские координаты обновления, ограничивающий область обновления.

Установите этот параметр в NULL чтобы определить, существует ли область обновления в пределах CWnd.Если lpRectNULL, функция-член GetUpdateRect возвращает ненулевое значение, если область обновления существует, и 0, если он не поддерживает.Это обеспечивает способ определения, является ли сообщение привело к WM_PAINT с недопустимой области.Не устанавливайте этот параметр в NULL в Windows версии 3.0 и выше.
bErase
Определяет, является ли фон в области обновления быть стертым.

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

Указывает состояние области обновления.Значение не равно нулю, если область обновления не пуста; в противном случае – значение 0.

Если параметр установлен в lpRectNULL, то возвращаемое значение не равно нулю, если область обновления существует; в противном случае – значение 0.

Заметки

Если CWnd было создано с учетом CS_OWNDC и режим сопоставления не MM_TEXT, функция-член GetUpdateRect предоставляет прямоугольник в логических координатах.В противном случае - значение GetUpdateRect предоставляет прямоугольник, в клиентских координатах., Если область обновления, то GetUpdateRect задает прямоугольник для быть пустым (наборы все координаты до 0).

Параметр bErase указывает, должно ли GetUpdateRect стереть фон области обновления.Если bEraseTRUE и область обновления не пуста, фон стерт.Для удаления фон, GetUpdateRect отправляет сообщение WM_ERASEBKGND.

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

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