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 |