GetLayeredWindowAttributes, fonction (winuser.h)

Article
03/04/2024

Récupère la clé de couleur d'opacité et de transparence d'une fenêtre superposée.

Syntaxe

BOOL GetLayeredWindowAttributes(
  [in]            HWND     hwnd,
  [out, optional] COLORREF *pcrKey,
  [out, optional] BYTE     *pbAlpha,
  [out, optional] DWORD    *pdwFlags
);

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 à l’aide de SetWindowLong après la création de la fenêtre.

[out, optional] pcrKey

Type : COLORREF*

Pointeur vers une valeur COLORREF qui reçoit la clé de couleur de transparence à utiliser lors de la composition de la fenêtre en couches. Tous les pixels peints par la fenêtre de cette couleur seront transparents. Cela peut être NULL si l’argument n’est pas nécessaire.

[out, optional] pbAlpha

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 la variable référencée par pbAlpha est 0, la fenêtre est complètement transparente. Lorsque la variable référencée par pbAlpha est 255, la fenêtre est opaque. Cela peut être NULL si l’argument n’est pas nécessaire.

[out, optional] pdwFlags

Type : DWORD*

Indicateur de superposition. Ce paramètre peut avoir la valeur NULL si la valeur n’est pas nécessaire. L’indicateur de superposition peut être une ou plusieurs des valeurs suivantes.

Valeur	Signification
LWA_ALPHA 0x00000002	Utilisez pbAlpha pour déterminer l’opacité de la fenêtre en couches.
LWA_COLORKEY 0x00000001	Utilisez pcrKey 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

GetLayeredWindowAttributes ne peut être appelé que si l’application a précédemment appelé SetLayeredWindowAttributes dans la fenêtre. La fonction échoue si la fenêtre en couches a été configurée avec UpdateLayeredWindow.

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

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows XP [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [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)