Funzione SetLayeredWindowAttributes (winuser.h)

Articolo
03/04/2024

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

Sintassi

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

Parametri

[in] hwnd

Tipo: HWND

Handle per la finestra a più livelli. Viene creata una finestra a più livelli specificando WS_EX_LAYERED durante la creazione della finestra con la funzione CreateWindowEx o impostando WS_EX_LAYERED tramite SetWindowLong dopo la creazione della finestra.

Windows 8: lo stile di WS_EX_LAYERED è supportato per le finestre di primo livello e le finestre figlio. Le versioni precedenti di Windows supportano WS_EX_LAYERED solo per le finestre di primo livello.

[in] crKey

Tipo: COLORREF

Struttura COLORREF che specifica la chiave del colore di trasparenza da utilizzare durante la composizione della finestra a più livelli. Tutti i pixel dipinti dalla finestra in questo colore saranno trasparenti. Per generare un COLORREF, utilizzare la macro RGB .

[in] bAlpha

Tipo: BYTE

Valore alfa usato per descrivere l'opacità della finestra a più livelli. Simile al membro SourceConstantAlpha della struttura BLENDFUNCTION . Quando bAlpha è 0, la finestra è completamente trasparente. Quando bAlpha è 255, la finestra è opaca.

[in] dwFlags

Tipo: DWORD

Un'azione da intraprendere. Questo parametro può essere uno o più dei valori seguenti.

Valore	Significato
LWA_ALPHA 0x00000002	Usare bAlpha per determinare l'opacità della finestra a più livelli.
LWA_COLORKEY 0x00000001	Usare crKey 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

Si noti che dopo aver chiamato SetLayeredWindowAttributes per una finestra a più livelli, le successive chiamate updateLayeredWindow avranno esito negativo fino a quando il bit dello stile di layering non viene cancellato e impostato di nuovo.

Per altre informazioni, vedere Using Layered Windows.For more information, see Using Layered Windows.

Requisiti

Requisito	Valore
Client minimo supportato	Windows 2000 Professional [solo app desktop]
Server minimo supportato	Windows 2000 Server [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)