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 |
---|---|
|
Verwenden Sie pbAlpha , um die Deckkraft des Mehrschichtfensters zu bestimmen. |
|
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
Referenz