Funzione GetLayeredWindowAttributes (winuser.h)

Articolo
03/13/2024

Recupera la chiave di colore per trasparenza e opacità di una finestra a livelli.

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle alla finestra a livelli. Viene creata una finestra a livelli specificando WS_EX_LAYERED quando si crea la finestra con la funzione CreateWindowEx o impostando WS_EX_LAYERED usando SetWindowLong dopo la creazione della finestra.

[out, optional] pcrKey

Tipo: COLORREF*

Puntatore a un valore COLORREF che riceve la chiave del colore di trasparenza da usare durante la composizione della finestra a livelli. Tutti i pixel dipinti dalla finestra in questo colore saranno trasparenti. Questo può essere NULL se l'argomento non è necessario.

[out, optional] pbAlpha

Tipo: BYTE*

Valore Alfa usato per descrivere l'opacità della finestra a livelli. Analogamente al membro SourceConstantAlpha della struttura BLENDFUNCTION . Quando la variabile a cui fa riferimento pbAlpha è 0, la finestra è completamente trasparente. Quando la variabile a cui fa riferimento pbAlpha è 255, la finestra è opaca. Questo può essere NULL se l'argomento non è necessario.

[out, optional] pdwFlags

Tipo: DWORD*

Flag di livello. Questo parametro può essere NULL se il valore non è necessario. Il flag di livello può essere uno o più dei valori seguenti.

Valore	Significato
LWA_ALPHA 0x00000002	Usare pbAlpha per determinare l'opacità della finestra a livelli.
LWA_COLORKEY 0x00000001	Usare pcrKey come colore di trasparenza.

Valore restituito

Tipo: BOOL

Se la funzione ha esito positivo, il valore restituito è diverso da zero.

Se la funzione ha esito negativo, il valore restituito è zero. Per informazioni dettagliate sull'errore, chiamare GetLastError.

Commenti

GetLayeredWindowAttributes può essere chiamato solo se l'applicazione ha precedentemente chiamato SetLayeredWindowAttributes nella finestra. La funzione avrà esito negativo se la finestra a livelli è stata configurata con UpdateLayeredWindow.

Per altre informazioni, vedere Uso di Windows a livelli.

Requisiti

Requisito	Valore
Client minimo supportato	Windows XP [solo app desktop]
Server minimo supportato	Windows Server 2003 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	winuser.h (include Windows.h)
Libreria	User32.lib
DLL	User32.dll
Set di API	ext-ms-win-ntuser-window-l1-1-1 (introdotto in Windows 8.1)