Функция GetUpdateRgn

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

Синтаксис

int GetUpdateRgn(
  HWND hWnd,    // дескриптор окна
  HRGN hRgn,    // дескриптор региона
  BOOL bErase   // состояние очистки
);

Параметры

hWnd

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

hRgn

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

bErase

[in] Определяет, должен ли фон окна быть стерт и должны ли нерабочие области дочерних окон рисоваться. Если этот параметр - FALSE, никакого рисования не делается.

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

Возвращаемое значение указывает степень сложности получающегося региона; это может быть одно из ниже перечисленных значений

Значение

Предназначение

COMPLEXREGION Регион состоит из более чем одного прямоугольника.
ERROR Произошла ошибка.
NULLREGION Регион пуст.
SIMPLEREGION Регион - отдельный прямоугольник.

Замечания

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

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисования

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

К 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