Функция BeginPaint

Функция BeginPaint готовит заданное окно к окрашиванию и заполняет структуру PAINTSTRUCT информацией об окрашивании.

Синтаксис

Параметры

[in] Дескриптор окна, которое будет перекрашено.

[out] Указатель на структуру PAINTSTRUCT, которая получит информацию об окрашивании.

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

Если функция завершается успешно, возвращаемое значение - дескриптор контекста устройства отображения для заданного окна.

Если функция завершается ошибкой, возвращаемое значение - NULL, которое указывает, что никакой контекст устройства (DC) отображения не доступен.

Windows NT/2000/XP: Чтобы получить дополнительную информацию об ошибке, вызовите GetLastError.

Замечания

Функция BeginPaint автоматически заставляет регион отсечения контекста устройства исключать любую область вне обновляемого региона. Обновляемый регион устанавливается функцией InvalidateRect или InvalidateRgn и системой после установки размеров, перемещения, создания, прокрутки или любой другой операции, которая воздействует на клиентскую (рабочую) область. Если обновленный регион отмечен для стирания, BeginPaint отправляет окну сообщение WM_ERASEBKGND.

Приложение не должно вызвать функцию BeginPaint, кроме как в ответ на сообщение WM_PAINT. У каждого вызова BeginPaint должен быть соответствующий вызов функции EndPaint.

Если каретка находится в области, которая будет окрашиваться, BeginPaint автоматически скрывает каретку, чтобы воспрепятствовать её стиранию.

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

Демонстрационный код

Пример смотри в статье Рисование в рабочей области.

Смотри также

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