Funzione DwmGetColorizationColor (dwmapi.h)

Articolo
08/23/2023

Recupera il colore corrente usato per la composizione di vetro DWM (Desktop Window Manager). Questo valore è basato sulla combinazione di colori corrente e può essere modificato dall'utente. Le applicazioni possono ascoltare le modifiche al colore gestendo la notifica di WM_DWMCOLORIZATIONCOLORCHANGED .

Sintassi

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

Parametri

[out] pcrColorization

Puntatore a un valore che, quando questa funzione restituisce correttamente, riceve il colore corrente utilizzato per la composizione di vetro. Il formato del colore del valore è 0xAARRGGBB.

[out] pfOpaqueBlend

Puntatore a un valore che, quando questa funzione restituisce correttamente, indica se il colore è una miscela opaca. TRUE se il colore è una miscela opaca; in caso contrario, FALSE.

Valore restituito

Se questa funzione ha esito positivo, restituisce S_OK. In caso contrario, restituisce un codice di errore HRESULT .

Commenti

Il valore indicato da pcrColorization è in formato 0xAARRGGBB. Molte API Microsoft Win32, ad esempio COLORREF, usano un formato 0x00BBGGRR. Prestare attenzione a garantire che vengano usati i colori previsti.

Esempio

Il codice di esempio seguente mostra un handle di notifica WM_DWMCOLORIZATIONCOLORCHANGED . Se viene ricevuta la notifica di colorazione, questo codice recupera il nuovo valore di colore.


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

Requisiti


Client minimo supportato	Windows Vista [solo app desktop]
Server minimo supportato	Windows Server 2008 [solo app desktop]
Piattaforma di destinazione	Windows
Intestazione	dwmapi.h
Libreria	Dwmapi.lib
DLL	Dwmapi.dll

Condividi tramite