Поделиться через


CWnd::GetUpdateRect

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

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 получает пустую область обновления.

Требования

Header: afxwin.h

См. также

Ссылки

Класс CWnd

Диаграмма иерархии

CWnd::BeginPaint

GetUpdateRect

CWnd::OnPaint

CWnd::RedrawWindow