クラシックデスクトップアプリの Windows テーマ追従

Windows には、パーソナライズの一部としてテーマ設定が存在し、「アクセントカラー」を選択することができます。
また、Windows 10 build 14316 から、アクセントカラーとは別に「app mode」として Light/Dark テーマを選択できるようになりました。

UWP アプリは SystemAccentColor などの一部のリソースを ThemeResource として指定することで、Windows のアクセントカラーやテーマによって決定される色に追従することが可能です。

一方で、クラシックデスクトップアプリにおいては、例えば WPF ではそのようなリソースが定義されておらず、フレームワークとして Windows テーマに追従する機能は実装されていません。
今回は、クラシックデスクトップアプリにおいて、Windows のテーマ設定に追従する方法について解説します。

ちなみに余談ですが、私は Windows デスクトップアプリが「クラシック」と表現されていることに納得していません。

アクセントカラーの取得

アクセントカラーは DwmGetColorizationColor 関数を使用して取得します。
マネージコードで書く場合は以下のように宣言しましょう。

public static class Dwmapi
{
    [DllImport("Dwmapi.dll")]
    public static extern void DwmGetColorizationColor([Out] out int pcrColorization, [Out] out bool pfOpaqueBlend);
}

public static class Dwmapi

{

[DllImport("Dwmapi.dll")]

public static extern void DwmGetColorizationColor([Out] out int pcrColorization, [Out] out bool pfOpaqueBlend);

}

第一引数でアクセントカラーが返ってきます。
整数型で 0xAARRGGBB のフォーマットになっていますので、以下のようにして Color 型にすると良いでしょう。

public static Color GetColorFromInt64(long color)
{
    return Color.FromArgb((byte)(color >> 24), (byte)(color >> 16), (byte)(color >> 8), (byte)color);
}

public static Color GetColorFromInt64(long color)

{

return Color.FromArgb((byte)(color >> 24), (byte)(color >> 16), (byte)(color >> 8), (byte)color);

}

この Color 型をもとに、例えば WPF アプリでは SolidColorBrush を生成すれば、クラシックデスクトップアプリでも Windows のアクセントカラーを取得してアプリに反映することができます。

ちなみに余談ですが、私は Windows デスクトップアプリが「クラシック」と表現されていることに納得していません。

テーマカラーの取得

前述のとおり、Windows 10 build 14316 から「app mode」として Light/Dark テーマを選択できるようになりました。
しかしながら、それ以前のビルドでも、設定 UI が提供されていないだけでテーマ設定自体は可能でした。

設定値はレジストリに保存されており、以下のキーと値で指定されます。
キー: HKCU\SOFTWARE\Microsoft\Windows\CurrentVersion\Themes\Personalize
値: AppsUseLightTheme

0 の場合は Dark テーマ、1 の場合は Light テーマが設定されています。
具体的にいつのビルド番号からは覚えていませんが、少なくとも Windows 10 build 10586 (4/27 時点でのリリースバージョン) では、上記レジストリ値を手動で設定することで、テーマ設定の変更が可能です (変更の適用にはサインアウトが必要です)。

アクセントカラーと違い、テーマ設定は RGB 値などの具体的な色情報を持っていないため、Light/Dark テーマでどのような色を使用するかは、アプリ開発者が設計および実装する必要があります。

例えば、Visual Studio のように Light/Dark などのテーマ設定が存在するクラシックデスクトップアプリにおいて、Windows のテーマ設定によって自動的に切り替えるような実装が可能となります (Visual Studio にはそのような機能は備わっていませんが…)。

ちなみに余談ですが、私は Windows デスクトップアプリが「クラシック」と表現されていることに納得していません。

アクセントカラーの動的な変更に対する追従

これまでの内容は設定値を取得するまでで、アプリの起動中にユーザーがアクセントカラーやテーマ設定を変更した場合に対応できません。
このような動的な変更に対しては、ウィンドウプロシージャで特定のウィンドウメッセージに対する処理を記述することで可能となります。

アクセントカラーの変更を通知するウィンドウメッセージは WM_DWMCOLORIZATIONCOLORCHANGED です。
wParam から 0xAARRGGBB のフォーマットで変更後の色が取得できます。

マネージコードで書くなら、以下のようになるでしょう。

if (msg == (int)WindowsMessages.WM_DWMCOLORIZATIONCOLORCHANGED)
{
    var color = ColorHelper.GetColorFromInt64((long)wParam); // ↑ で定義したやつ

    // アクセント カラーの変更通知とか諸々

    handled = true;
}

if (msg == (int)WindowsMessages.WM_DWMCOLORIZATIONCOLORCHANGED)

{

var color = ColorHelper.GetColorFromInt64((long)wParam); // ↑ で定義したやつ

// アクセントカラーの変更通知とか諸々

handled = true;

}

この方法は、ウィンドウメッセージを受信するために、1 つ以上のトップレベルウィンドウが必要です。
WPF のウィンドウでウィンドウプロシージャと同等のコードを実装する方法は、多くの方が既に解説されています。

しかしながら、ウィンドウを持たないライブラリ等に上記の機能を実装する必要がある場合でも、以下のようにして不可視のウィンドウを生成し、メッセージを受信させることで対応可能です。

public void ShowTransparentWindow()
{
    var parameters = new HwndSourceParameters("")
    {
        Width = 1,
        Height = 1,
        WindowStyle = (int)WindowStyles.WS_BORDER,
    };
    var source = new HwndSource(parameters);
    source.AddHook(WndProc);
}

protected IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)
{
    // ウィンドウ メッセージの受信ほげもげ
    return IntPtr.Zero;
}

public void ShowTransparentWindow()

{

var parameters = new HwndSourceParameters("")

{

Width = 1,

Height = 1,

WindowStyle = (int)WindowStyles.WS_BORDER,

};

var source = new HwndSource(parameters);

source.AddHook(WndProc);

}

protected IntPtr WndProc(IntPtr hwnd, int msg, IntPtr wParam, IntPtr lParam, ref bool handled)

{

// ウィンドウメッセージの受信ほげもげ

return IntPtr.Zero;

}

HwndSource クラスは、WPF 向けに低レイヤーの Win32 機能を公開しており、HwndSourceParameters 構造体を使用してインスタンス化することで、不可視となるようなウィンドウスタイルを指定して Win32 ウィンドウを作ることができます。

これらの手段により、クラシックデスクトップアプリ、ならびにそのライブラリにおいて、動的に変更されるアクセントカラーを都度取得して対応することができます。

また WPF の場合、取得した色情報は SolidColorBrush としてリソース化しつつ設定変更を検知したら書き換えることにより、DynamicResource で参照すれば、UWP の ThemeResource と同様のことができます。

ちなみに余談ですが、私は Windows デスクトップアプリが「クラシック」と表現されていることに納得していません。

テーマカラーの動的な変更に対する追従

このセクションの内容は、Windows 10 build 14316 以降のみで使用できます。

前述のとおり、Windows 10 build 14316 ではテーマに対する設定 UI が提供され、リアルタイムで Light/Dark の切り替えが可能となりました。
アクセントカラーと同様に、テーマ設定の変更はウィンドウメッセージで通知されるため、アクセントカラーと同じ方法で対応することができます。

テーマ設定の変更を通知するウィンドウメッセージは WM_SETTINGCHANGE です。
lParam ならびに wParam で変更後の設定値は提供されないため、アクセントカラーと違ってメッセージを受信したら再度レジストリから取得する必要がある点に注意してください。

マネージコードで書く場合は以下のようになるでしょう。

if (msg == (int)WindowsMessages.WM_SETTINGCHANGE)
{
    var systemParmeter = Marshal.PtrToStringAuto(lParam);
    if (systemParmeter == "ImmersiveColorSet")
    {
        // 再度レジストリから Dark/Light をとってくるとか

        handled = true;
    }
}

if (msg == (int)WindowsMessages.WM_SETTINGCHANGE)

{

var systemParmeter = Marshal.PtrToStringAuto(lParam);

if (systemParmeter == "ImmersiveColorSet")

{

// 再度レジストリから Dark/Light をとってくるとか

handled = true;

}

ちなみに余談ですが、私は Windows デスクトップアプリが「クラシック」と表現されていることに納得していません。

MetroRadiance

今回の内容をすべて実装するのは骨が折れそうですし、例によって既にライブラリ化しておきました。

MetroRadiance に含まれる MetroRadiance.Core プロジェクトで、以下を実装しています。

アクセントカラーの取得
アクセントカラーの変更への追従
テーマ設定の取得
テーマ設定の変更への追従
ライブラリでウィンドウメッセージ受信してあれこれ (HwndSource で不可視ウィンドウあれこれ) の例

同梱されているサンプルアプリ (MetroRadiance.Showcase) で UI をテーマ設定に追従させた様子が以下になります。
左側が自作アプリ、右側が Windows 10 14328 の設定アプリです。

実装例として参考にして頂ければと思います。
もしくは、NuGet から MetroRadiance.Core 2.2.0 以降をインストールして使ってみてください。

使用方法は GitHub の readme をご覧隊頂ければ。
また不明点や不具合等ありましたら @Grabacr07 までお願いします。

おわりに

私は Windows デスクトップアプリが「クラシック」と表現されていることに納得していません。

アクセント カラーの取得

テーマ カラーの取得

アクセント カラーの動的な変更に対する追従

テーマ カラーの動的な変更に対する追従

MetroRadiance

おわりに

コメントを残す コメントをキャンセル

アクセントカラーの取得

テーマカラーの取得

アクセントカラーの動的な変更に対する追従

テーマカラーの動的な変更に対する追従

コメントを残すコメントをキャンセル