Fonction DwmGetColorizationColor (dwmapi.h)

Article
08/23/2023

Récupère la couleur actuelle utilisée pour la composition en verre du Gestionnaire de fenêtres de bureau (DWM). Cette valeur est basée sur le jeu de couleurs actuel et peut être modifiée par l’utilisateur. Les applications peuvent écouter les modifications de couleur en gérant la notification WM_DWMCOLORIZATIONCOLORCHANGED .

Syntaxe

HRESULT DwmGetColorizationColor(
  [out] DWORD *pcrColorization,
  [out] BOOL  *pfOpaqueBlend
);

Paramètres

[out] pcrColorization

Pointeur vers une valeur qui, lorsque cette fonction retourne correctement, reçoit la couleur actuelle utilisée pour la composition du verre. Le format de couleur de la valeur est 0xAARRGGBB.

[out] pfOpaqueBlend

Pointeur vers une valeur qui, lorsque cette fonction retourne correctement, indique si la couleur est un mélange opaque. TRUE si la couleur est un mélange opaque ; sinon, FALSE.

Valeur retournée

Si cette fonction réussit, elle retourne S_OK. Sinon, elle retourne un code d’erreur HRESULT.

Notes

La valeur pointée par pcrColorization est au format 0xAARRGGBB. De nombreuses API Microsoft Win32, telles que COLORREF, utilisent un format 0x00BBGGRR. Veillez à ce que les couleurs prévues soient utilisées.

Exemples

L’exemple de code suivant montre un handle de notification WM_DWMCOLORIZATIONCOLORCHANGED . Si la notification de colorisation est reçue, ce code récupère la nouvelle valeur de couleur.


...
DWORD color = 0;
BOOL opaque = FALSE;
  
HRESULT hr = DwmGetColorizationColor(&color, &opaque);
if (SUCCEEDED(hr))
{
  // Update the application to use the new color.
}
...

Spécifications


Client minimal pris en charge	Windows Vista [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2008 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	dwmapi.h
Bibliothèque	Dwmapi.lib
DLL	Dwmapi.dll

Partager via