SetLayeredWindowAttributes, fonction (winuser.h)

Définit la clé de couleur d'opacité et de transparence d'une fenêtre superposée.

Syntaxe

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

Paramètres

[in] hwnd

Type : HWND

Handle de la fenêtre en couches. Une fenêtre en couches est créée en spécifiant WS_EX_LAYERED lors de la création de la fenêtre avec la fonction CreateWindowEx ou en définissant WS_EX_LAYERED via SetWindowLong après la création de la fenêtre.

Windows 8 : le style WS_EX_LAYERED est pris en charge pour les fenêtres de niveau supérieur et les fenêtres enfants. Les versions précédentes de Windows prennent en charge WS_EX_LAYERED uniquement pour les fenêtres de niveau supérieur.

[in] crKey

Type : COLORREF

Structure COLORREF qui spécifie la clé de couleur de transparence à utiliser lors de la composition de la fenêtre superposée. Tous les pixels peints par la fenêtre dans cette couleur seront transparents. Pour générer un COLORREF, utilisez la macro RVB .

[in] bAlpha

Type : BYTE

Valeur alpha utilisée pour décrire l’opacité de la fenêtre en couches. Semblable au membre SourceConstantAlpha de la structure BLENDFUNCTION . Lorsque bAlpha a la valeur 0, la fenêtre est complètement transparente. Lorsque bAlpha a la valeur 255, la fenêtre est opaque.

[in] dwFlags

Type : DWORD

Action à entreprendre. Ce paramètre peut prendre une ou plusieurs des valeurs suivantes.

Valeur retournée

Type : BOOL

Si la fonction réussit, la valeur de retour est différente de zéro.

Si la fonction échoue, la valeur de retour est égale à zéro. Pour obtenir des informations détaillées sur l’erreur, appelez GetLastError.

Remarques

Notez qu’une fois que SetLayeredWindowAttributes a été appelé pour une fenêtre en couches, les appels UpdateLayeredWindow suivants échouent jusqu’à ce que le bit de style de superposition soit effacé et à nouveau défini.

Pour plus d’informations, consultez Utilisation de Windows en couches.

Configuration requise

Voir aussi

AlphaBlend

COLORREF

Conceptuel

CreateWindowEx

Autres ressources

RGB

Référence

SetWindowLong

TransparentBlt

UpdateLayeredWindow

Utilisation de Windows

Windows