Функция InvalidateRgn (winuser.h)
Функция 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) |