Funzione GetLayeredWindowAttributes (winuser.h)
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 |
---|---|
|
Usare pbAlpha per determinare l'opacità della finestra a livelli. |
|
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) |
Vedi anche
Informazioni concettuali
Riferimento