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 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

Vedi anche

AlphaBlend

COLORREF

Informazioni concettuali

CreateWindowEx

Altre risorse

RGB

Riferimento

Setwindowlong

TransparentBlt

UpdateLayeredWindow

Uso di Windows

Windows