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