BeginBufferedPaint-Funktion (uxtheme.h)

Startet einen gepufferten Paint-Vorgang.

Syntax

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

Die Parameter

hdcTarget

Typ: HDC

Das Handle des Ziel-DC, auf dem der Puffer gezeichnet wird.

prcTarget

Typ: const RECT*

Ein Zeiger auf eine RECT-Struktur , die den Bereich des Ziel-DC angibt, in dem strichen werden soll.

dwFormat

Typ: BP_BUFFERFORMAT

Ein Element der BP_BUFFERFORMAT-Aufzählung , die das Format des Puffers angibt.

[in] pPaintParams

Typ: BP_PAINTPARAMS*

Ein Zeiger auf eine BP_PAINTPARAMS Struktur, die die Farbvorgangsparameter definiert. Dieser Wert kann NULL-sein.

[out] phdc

Typ: HDC*

Wenn diese Funktion zurückgegeben wird, verweist sie auf das Handle des neuen Gerätekontexts.

Rückgabewert

Typ: HPAINTBUFFER

Ein Handle für den gepufferten Paint-Kontext. Wenn diese Funktion fehlschlägt, ist der Rückgabewert NULL, und phdc ist NULL. Rufen Sie GetLastError auf, um erweiterte Fehlerinformationen abzurufen.

Der zurückgegebene Handle wird freigegeben, wenn EndBufferedPaint aufgerufen wird.

Eine Anwendung sollte "BufferedPaintInit " im aufrufenden Thread aufrufen, bevor Sie "BeginBufferedPaintPaint" und "BufferedPaintUnInit " aufrufen, bevor der Thread beendet wird. Fehler beim Aufrufen von BufferedPaintInit kann zu einer beeinträchtigten Leistung führen, da interne Daten initialisiert und für jeden gepufferten Paint-Vorgang zerstört werden.

Anforderungen