Функция InvalidateRgn

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

Синтаксис

Параметры

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

[in] Дескриптор региона, который будет добавлен к обновляемому региону. Предполагается, что регион имеет координаты рабочей области. Если этот параметр - NULL, вся рабочая область добавляется к обновляемому региону.

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

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

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

Замечания

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

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

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

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

Смотри также

Обзор Окрашивание и рисование, Функции окрашивания и рисования, BeginPaint, InvalidateRect, ValidateRect, ValidateRgn, WM_PAINT