Функция GetUpdateRgn (winuser.h)

  • Статья

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

Синтаксис

int GetUpdateRgn(
  [in] HWND hWnd,
  [in] HRGN hRgn,
  [in] BOOL bErase
);

Параметры

[in] hWnd

Дескриптор в окне с регионом обновления, который требуется извлечь.

[in] hRgn

Дескриптор в регионе для получения региона обновления.

[in] bErase

Указывает, следует ли стереть фон окна и следует ли отрисовыть неклиентные области дочерних окон. Если этот параметр имеет значение FALSE, рисование не выполняется.

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

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

Значение Значение
COMPLEXREGION Область состоит из нескольких прямоугольников.
ОШИБКА Произошла ошибка.
NULLREGION Область пуста.
SIMPLEREGION Область представляет собой один прямоугольник.

Комментарии

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

Требования

   
Минимальная версия клиента Windows 2000 Professional [только классические приложения]
Минимальная версия сервера Windows 2000 Server [только классические приложения]
Целевая платформа Windows
Header winuser.h (включая Windows.h)
Библиотека User32.lib
DLL User32.dll
Набор API ext-ms-win-ntuser-draw-l1-1-0 (появилось в Windows 8)

См. также раздел

Функции рисования и рисования

Общие сведения о рисовании и рисовании