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

Статья
08/27/2023

Функция InvalidateRgn делает недействительной клиентную область в указанном регионе, добавляя ее в текущую область обновления окна. Недействительная область вместе со всеми другими областями в регионе обновления помечается для рисования при появлении следующего сообщения WM_PAINT .

Синтаксис

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

Параметры

[in] hWnd

Дескриптор окна с областью обновления, которая должна быть изменена.

[in] hRgn

Дескриптор для региона, добавляемого в регион обновления. Предполагается, что регион имеет клиентские координаты. Если этот параметр имеет значение NULL, в регион обновления добавляется вся клиентская область.

[in] bErase

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

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

Возвращаемое значение всегда не равно нулю.

Недействительные области накапливаются в области обновления до обработки следующего сообщения WM_PAINT или до тех пор, пока регион не будет проверен с помощью функции ValidateRect или ValidateRgn .

Система отправляет WM_PAINT сообщение в окно всякий раз, когда область обновления не пуста и в очереди приложений для этого окна нет других сообщений.

Указанный регион должен быть создан с помощью одной из функций региона.

Если параметр bErase имеет значение TRUE для любой части области обновления, фон во всем регионе удаляется, а не только в указанной части.

Требования

Требование	Значение
Минимальная версия клиента	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)