Compartir a través de

Función DwmGetColorizationColor (dwmapi.h)

  • Artículo

Recupera el color actual usado para la composición de vidrio del Administrador de ventanas de escritorio (DWM). Este valor se basa en la combinación de colores actual y el usuario puede modificarlo. Las aplicaciones pueden escuchar los cambios de color controlando la notificación de WM_DWMCOLORIZATIONCOLORCHANGED .

Sintaxis

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

Parámetros

[out] pcrColorization

Puntero a un valor que, cuando esta función devuelve correctamente, recibe el color actual utilizado para la composición de vidrio. El formato de color del valor es 0xAARRGGBB.

[out] pfOpaqueBlend

Puntero a un valor que, cuando esta función devuelve correctamente, indica si el color es una mezcla opaca. TRUE si el color es una mezcla opaca; de lo contrario, FALSE.

Valor devuelto

Si esta función se realiza correctamente, devuelve S_OK. De lo contrario, devuelve un código de error de HRESULT.

Comentarios

El valor al que apunta pcrColorization tiene un formato 0xAARRGGBB. Muchas API de Microsoft Win32, como COLORREF, usan un formato 0x00BBGGRR. Tenga cuidado de asegurarse de que se usan los colores previstos.

Ejemplos

En el código de ejemplo siguiente se muestra un identificador de notificación WM_DWMCOLORIZATIONCOLORCHANGED . Si se recibe la notificación de colorización, este código recupera el nuevo valor de color.


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

Requisitos

   
Cliente mínimo compatible Windows Vista [solo aplicaciones de escritorio]
Servidor mínimo compatible Windows Server 2008 [solo aplicaciones de escritorio]
Plataforma de destino Windows
Encabezado dwmapi.h
Library Dwmapi.lib
Archivo DLL Dwmapi.dll