GetLayeredWindowAttributes-Funktion (winuser.h)

Artikel
03/13/2024

Ruft die Deckkraft- und Transparenzfarbenschlüssel eines überlappenden Fensters ab.

Syntax

BOOL GetLayeredWindowAttributes(
  [in]            HWND     hwnd,
  [out, optional] COLORREF *pcrKey,
  [out, optional] BYTE     *pbAlpha,
  [out, optional] DWORD    *pdwFlags
);

Parameter

[in] hwnd

Typ: HWND

Ein Handle für das mehrschichtige Fenster. Ein mehrschichtiges Fenster wird erstellt, indem WS_EX_LAYERED beim Erstellen des Fensters mit der CreateWindowEx-Funktion oder durch Festlegen WS_EX_LAYERED mithilfe von SetWindowLong festgelegt wird, nachdem das Fenster erstellt wurde.

[out, optional] pcrKey

Typ: COLORREF*

Ein Zeiger auf einen COLORREF-Wert , der den Transparenzfarbschlüssel empfängt, der beim Komponieren des mehrschichtigen Fensters verwendet werden soll. Alle Pixel, die vom Fenster in dieser Farbe gezeichnet werden, sind transparent. Dies kann NULL sein, wenn das Argument nicht benötigt wird.

[out, optional] pbAlpha

Typ: BYTE*

Der Alpha-Wert, der verwendet wird, um die Deckkraft des Mehrschichtfensters zu beschreiben. Ähnlich dem SourceConstantAlpha-Element der BLENDFUNCTION-Struktur . Wenn die Variable, auf die von pbAlpha verwiesen wird, 0 ist, ist das Fenster vollständig transparent. Wenn die variable, auf die von pbAlpha verwiesen wird, 255 ist, ist das Fenster undurchsichtig. Dies kann NULL sein, wenn das Argument nicht benötigt wird.

[out, optional] pdwFlags

Typ: DWORD*

Ein Layeringflag. Dieser Parameter kann NULL sein, wenn der Wert nicht benötigt wird. Das Layering-Flag kann mindestens einer der folgenden Werte sein.

Wert	Bedeutung
LWA_ALPHA 0x00000002	Verwenden Sie pbAlpha , um die Deckkraft des Mehrschichtfensters zu bestimmen.
LWA_COLORKEY 0x00000001	Verwenden Sie pcrKey als Transparenzfarbe.

Rückgabewert

Typ: BOOL

Wenn die Funktion erfolgreich ist, ist der Rückgabewert ungleich Null.

Wenn die Funktion fehlerhaft ist, ist der Rückgabewert null. Um erweiterte Fehlerinformationen zu erhalten, rufen Sie GetLastError auf.

Hinweise

GetLayeredWindowAttributes kann nur aufgerufen werden, wenn die Anwendung im Fenster zuvor SetLayeredWindowAttributes aufgerufen hat. Die Funktion schlägt fehl, wenn das Mehrschichtfenster mit UpdateLayeredWindow eingerichtet wurde.

Weitere Informationen finden Sie unter Verwenden von Mehrschichtfenstern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows XP [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	winuser.h (einschließlich Windows.h)
Bibliothek	User32.lib
DLL	User32.dll
APIs	ext-ms-win-ntuser-window-l1-1-1 (eingeführt in Windows 8.1)