Funzione BeginBufferedPaint (uxtheme.h)

Avvia un'operazione di disegno memorizzata nel buffer.

Sintassi

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

Parametri

hdcTarget

Tipo: HDC

Handle del controller di dominio di destinazione in cui verrà disegnato il buffer.

prcTarget

Tipo: const RECT*

Puntatore a una struttura RECT che specifica l'area del controller di dominio di destinazione in cui disegnare.

dwFormat

Tipo: BP_BUFFERFORMAT

Membro dell'enumerazione BP_BUFFERFORMAT che specifica il formato del buffer.

[in] pPaintParams

Tipo: BP_PAINTPARAMS*

Puntatore a una struttura BP_PAINTPARAMS che definisce i parametri dell'operazione di disegno. Questo valore può essere NULL.

[out] phdc

Tipo: HDC*

Quando questa funzione viene restituita, punta all'handle del nuovo contesto di dispositivo.

Valore restituito

Tipo: HPAINTBUFFER

Handle per il contesto di disegno memorizzato nel buffer. Se questa funzione ha esito negativo, il valore restituito è NULL e phdc è NULL. Per informazioni dettagliate sull'errore, chiamare GetLastError.

L'handle restituito viene liberato quando viene chiamato EndBufferedPaint .

Un'applicazione deve chiamare BufferedPaintInit nel thread chiamante prima di chiamare BeginBufferedPaint e BufferedPaintUnInit prima che il thread venga terminato. La mancata chiamata a BufferedPaintInit può comportare prestazioni ridotte a causa dell'inizializzazione e dell'eliminazione definitiva dei dati interni per ogni operazione di disegno memorizzata nel buffer.

Requisiti

Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	uxtheme.h
DLL	UxTheme.dll