dwmGetColorizationColor 函式 (dwmapi.h)

擷取桌面視窗管理員 (DWM) 玻璃組合所使用的目前色彩。 此值是以目前的色彩配置為基礎，而且可由使用者修改。 應用程式可以藉由處理 WM_DWMCOLORIZATIONCOLORCHANGED 通知來接聽色彩變更。

語法

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

參數

[out] pcrColorization

值指標，當此函式成功傳回時，會收到用於玻璃組合的目前色彩。 值的色彩格式為 0xAARRGGBB。

[out] pfOpaqueBlend

值指標，當此函式成功傳回時，表示色彩是否不透明混合。 如果色彩不透明，則為TRUE;否則為FALSE。

傳回值

如果此函式成功，則會傳回 S_OK。 否則，它會傳回 HRESULT 錯誤碼。

備註

以 0xAARRGGBB 格式表示 由pcrColorization 所指向的值。 許多 Microsoft WIN32 API，例如 COLORREF，都使用 0x00BBGGRR 格式。 請小心確保使用預期的色彩。

範例

下列範例程式碼示範 WM_DWMCOLORIZATIONCOLORCHANGED 通知控制碼。 如果收到著色通知，此程式碼會擷取新的色彩值。

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

需求

最低支援的用戶端	Windows Vista [僅限傳統型應用程式]
最低支援的伺服器	Windows Server 2008 [僅限傳統型應用程式]
目標平台	Windows
標頭	dwmapi.h
程式庫	Dwmapi.lib
Dll	Dwmapi.dll