Функция BeginBufferedPaint (uxtheme.h)

Статья
08/26/2023

Начинает операцию буферизованного рисования.

Синтаксис

HPAINTBUFFER BeginBufferedPaint(
        HDC             hdcTarget,
        const RECT      *prcTarget,
        BP_BUFFERFORMAT dwFormat,
  [in]  BP_PAINTPARAMS  *pPaintParams,
  [out] HDC             *phdc
);

Параметры

hdcTarget

Тип: HDC

Дескриптор целевого контроллера домена, на котором будет закрашен буфер.

prcTarget

Тип: const RECT*

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

dwFormat

Тип: BP_BUFFERFORMAT

Член перечисления BP_BUFFERFORMAT , задающий формат буфера.

[in] pPaintParams

Тип: BP_PAINTPARAMS*

Указатель на структуру BP_PAINTPARAMS , которая определяет параметры операции рисования. Это значение может иметь значение NULL.

[out] phdc

Тип: HDC*

Когда эта функция возвращает значение , указывает на дескриптор нового контекста устройства.

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

Тип: HPAINTBUFFER

Дескриптор буферизованного контекста рисования. Если эта функция завершается сбоем, возвращается значение NULL, а phdc — NULL. Дополнительные сведения об ошибке можно получить, вызвав GetLastError.

Возвращенный дескриптор освобождается при вызове EndBufferedPaint .

Приложение должно вызывать BufferedPaintInit в вызывающем потоке перед вызовом BeginBufferedPaint иBufferedPaintUnInit перед завершением потока. Сбой вызова BufferedPaintInit может привести к снижению производительности из-за инициализации и уничтожения внутренних данных для каждой операции по краске в буфере.

Требования


Минимальная версия клиента	Windows Vista [только классические приложения]
Минимальная версия сервера	Windows Server 2008 [только классические приложения]
Целевая платформа	Windows
Header	uxtheme.h
DLL	UxTheme.dll