Freigeben über


GetLayeredWindowAttributes-Funktion (winuser.h)

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)

Siehe auch

Konzept

Createwindowex

Referenz

SetLayeredWindowAttributes

SetWindowLong

Verwenden von Windows

Windows