DwmGetColorizationColor-Funktion (dwmapi.h)

Artikel
08/23/2023

Ruft die aktuelle Farbe ab, die für die DWM-Glaskomposition (Desktop Window Manager) verwendet wird. Dieser Wert basiert auf dem aktuellen Farbschema und kann vom Benutzer geändert werden. Anwendungen können auf Farbänderungen lauschen, indem sie die WM_DWMCOLORIZATIONCOLORCHANGED Benachrichtigung behandeln.

Syntax

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

Parameter

[out] pcrColorization

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Funktion die aktuelle Farbe empfängt, die für die Glaszusammensetzung verwendet wird. Das Farbformat des Werts ist 0xAARRGGBB.

[out] pfOpaqueBlend

Ein Zeiger auf einen Wert, der bei erfolgreicher Rückgabe dieser Funktion angibt, ob es sich bei der Farbe um eine undurchsichtige Mischung handelt. TRUE , wenn die Farbe eine undurchsichtige Mischung ist; andernfalls FALSE.

Rückgabewert

Wenn diese Funktion erfolgreich ist, gibt sie S_OK zurück. Andernfalls wird ein Fehlercode HRESULT zurückgegeben.

Hinweise

Der Wert, auf den von pcrColorization verwiesen wird, hat ein 0xAARRGGBB-Format. Viele Microsoft Win32-APIs, z. B . COLORREF, verwenden das Format 0x00BBGGRR. Achten Sie darauf, dass die beabsichtigten Farben verwendet werden.

Beispiele

Der folgende Beispielcode zeigt ein WM_DWMCOLORIZATIONCOLORCHANGED Benachrichtigungshandle. Wenn die Farbgebungsbenachrichtigung empfangen wird, ruft dieser Code den neuen Farbwert ab.


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

Anforderungen


Unterstützte Mindestversion (Client)	Windows Vista [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2008 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	dwmapi.h
Bibliothek	Dwmapi.lib
DLL	Dwmapi.dll

Freigeben über