GetLayeredWindowAttributes, fonction (winuser.h)

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

Voir aussi

Conceptuel

CreateWindowEx

Référence

SetLayeredWindowAttributes

SetWindowLong

Utilisation de Windows

Windows