SetLayeredWindowAttributes-Funktion (winuser.h)

Artikel
03/04/2024

Legt die Deckkraft- und Transparenzfarbenschlüssel eines überlappenden Fensters fest.

Syntax

BOOL SetLayeredWindowAttributes(
  [in] HWND     hwnd,
  [in] COLORREF crKey,
  [in] BYTE     bAlpha,
  [in] DWORD    dwFlags
);

Parameter

[in] hwnd

Typ: HWND

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

Windows 8: Der WS_EX_LAYERED-Stil wird für Fenster der obersten Ebene und untergeordnete Fenster unterstützt. Frühere Windows-Versionen unterstützen WS_EX_LAYERED nur für Fenster der obersten Ebene.

[in] crKey

Typ: COLORREF

Eine COLORREF-Struktur , die den Transparenzfarbschlüssel angibt, der beim Komponieren des mehrschichtigen Fensters verwendet werden soll. Alle Pixel, die vom Fenster in dieser Farbe gezeichnet werden, sind transparent. Um ein COLORREF zu generieren, verwenden Sie das RGB-Makro .

[in] bAlpha

Typ: BYTE

Alphawert, der verwendet wird, um die Deckkraft des Mehrschichtfensters zu beschreiben. Ähnlich dem SourceConstantAlpha-Element der BLENDFUNCTION-Struktur . Wenn bAlpha 0 ist, ist das Fenster völlig transparent. Wenn bAlpha 255 ist, ist das Fenster undurchsichtig.

[in] dwFlags

Art: DWORD

Eine zu ergreifende Aktion. Dieser Parameter kann einen oder mehrere der folgenden Werte aufweisen.

Wert	Bedeutung
LWA_ALPHA 0x00000002	Verwenden Sie bAlpha , um die Deckkraft des Mehrschichtfensters zu bestimmen.
LWA_COLORKEY 0x00000001	Verwenden Sie crKey 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

Beachten Sie, dass nach dem Aufruf von SetLayeredWindowAttributes für ein Mehrschichtfenster nachfolgende UpdateLayeredWindow-Aufrufe fehlschlagen, bis das Ebenenformatbit gelöscht und erneut festgelegt wird.

Weitere Informationen finden Sie unter Verwenden von Mehrschichtfenstern.

Anforderungen

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows 2000 Server [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)