DwmGetColorizationColor 関数 (dwmapi.h)
デスクトップ ウィンドウ マネージャー (DWM) ガラスコンポジションに使用されている現在の色を取得します。 この値は現在の配色に基づいており、ユーザーが変更できます。 アプリケーションは、 WM_DWMCOLORIZATIONCOLORCHANGED 通知を処理することで、色の変更をリッスンできます。
構文
HRESULT DwmGetColorizationColor(
[out] DWORD *pcrColorization,
[out] BOOL *pfOpaqueBlend
);
パラメーター
[out] pcrColorization
この関数が正常に戻ったときに、ガラス合成に使用されている現在の色を受け取る値へのポインター。 値の色形式は 0xAARRGGBB です。
[out] pfOpaqueBlend
この関数が正常に返されるときに、色が不透明なブレンドであるかどうかを示す値へのポインター。 色 が不透明なブレンドの場合は TRUE。それ以外の場合は FALSE。
戻り値
この関数が成功すると、 S_OKが返されます。 そうでない場合は、HRESULT エラー コードを返します。
解説
pcrColorization によって指される値は、0xAARRGGBB 形式です。 COLORREF などの多くの Microsoft Win32 API では、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 |
Library | Dwmapi.lib |
[DLL] | Dwmapi.dll |