SetLayeredWindowAttributes, fonction (winuser.h)

Article
03/04/2024

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	Signification
LWA_ALPHA 0x00000002	Utilisez bAlpha pour déterminer l’opacité de la fenêtre en couches.
LWA_COLORKEY 0x00000001	Utilisez crKey comme couleur de transparence.

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

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows 2000 Server [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	winuser.h (inclure Windows.h)
Bibliothèque	User32.lib
DLL	User32.dll
Ensemble d’API	ext-ms-win-ntuser-window-l1-1-1 (introduit dans Windows 8.1)