Condividi tramite


Funzione SetLayeredWindowAttributes (winuser.h)

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)

Vedi anche

AlphaBlend

COLORREF

Informazioni concettuali

CreateWindowEx

Altre risorse

RGB

Riferimento

Setwindowlong

TransparentBlt

UpdateLayeredWindow

Uso di Windows

Windows