BufferedPaintSetAlpha-Funktion (uxtheme.h)

Legt die Alpha auf einen angegebenen Wert in einem bestimmten Rechteck fest. Die Alpha steuert die Transparenz, die beim Mischen mit dem Puffer auf den Zielgerätekontext (Dc) angewendet wird.

Syntax

HRESULT BufferedPaintSetAlpha(
       HPAINTBUFFER hBufferedPaint,
  [in] const RECT   *prc,
       BYTE         alpha
);

Parameter

hBufferedPaint

Typ: HPAINTBUFFER

Das Handle des gepufferten Malkontexts, der über BeginBufferedPaint abgerufen wird.

[in] prc

Typ: const RECT*

Ein Zeiger auf eine RECT-Struktur , die das Rechteck angibt, in dem die Alpha festgelegt werden soll. Legen Sie diesen Parameter auf NULL fest, um den gesamten Puffer anzugeben.

alpha

Typ: BYTE

Der festzulegende Alphawert. Der Alphawert kann zwischen Null (vollständig transparent) und 255 (vollständig undurchsichtig) liegen.

Rückgabewert

Typ: HRESULT

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Diese Funktion legt den Alphawert für jedes Pixel im Zielrechteck fest. Durch das Übergeben eines Alphawerts von 255 werden Pixel vollständig undurchsichtig. Das In uxtheme.h definierte BufferedPaintMakeOpaque-Makro legt Alphawerte auf 255 fest. Es wird in der Regel verwendet, um GDI aufzurufen, um in einen Speicherpuffer zu zeichnen und ihn dann undurchsichtig zu machen, um es auf Glas zu zeichnen.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	uxtheme.h
DLL	UxTheme.dll