知識マップ: Windowsアプリのダークモードとコントラストテーマ対応 ── DWMのダークタイトルバー、WinForms/WPFのシステムテーマ追従、ハイコントラスト時の描画

記事「Windowsアプリのダークモードとコントラストテーマ対応 ── DWMのダークタイトルバー、WinForms/WPFのシステムテーマ追従、ハイコントラスト時の描画」の主張を、概念と関係(エッジ)に分解した知識グラフの全体です。各関係には根拠・確認日・確度が付いています。

Windowsのテーマは「設定 > 個人用設定 > 色」のライト/ダーク(カラーモード)と「設定 > アクセシビリティ > コントラストテーマ」の2軸で、コントラストテーマが有効な間はダークモードが使えないため判定はコントラストテーマが先です。既存アプリのタイトルバーが白いままなのは互換性のための既定で、DwmSetWindowAttributeのDWMWA_USE_IMMERSIVE_DARK_MODE(値20)にTRUEを渡すとシステムがダークのときにダークで描かれます。現在のモードはUISettingsの前景色の明るさで判定し、変更通知で塗り直します。WinFormsは.NET 9/10のSetColorMode、WPFは.NET 9/10のThemeModeが実装を担い、コントラストテーマ時はSPI_GETHIGHCONTRAST系で判定して色をシステムカラーのペアに写像します。標準サポートの無いランタイムではライト固定を明示しますが、コントラストテーマ対応だけは固定できません。

flowchart LR
    accTitle: Windowsアプリのダークモードとコントラストテーマ対応の知識マップ
    accDescr: ライト/ダークのカラーモードとコントラストテーマの関係、DwmSetWindowAttributeによるダークタイトルバー、UISettingsによる検知とテーマ変更の通知、WinFormsのSetColorModeとWPFのThemeModeによる実装、コントラストテーマの検知APIとシステムカラーの前景/背景ペア、ライト固定の方針を示す図
    windows_color_mode["カラーモード(ライト/ダーク)"]
    contrast_theme["コントラストテーマ(ハイコントラスト)"]
    dwmwa_use_immersive_dark_mode["DWMWA_USE_IMMERSIVE_DARK_MODE"]
    dark_title_bar["ダークタイトルバー"]
    dwm_set_window_attribute["DwmSetWindowAttribute"]
    windows_11["Windows 11"]
    dwm_caption_color_attributes["DWMのタイトルバー色属性"]
    dwm_system_backdrop["DWMのシステム背景素材(Mica/Acrylic)"]
    uisettings_color_values["UISettingsによるカラーモードの取得と変更通知"]
    apps_use_light_theme_registry["AppsUseLightThemeレジストリ値"]
    theme_change_notification["テーマ変更の通知"]
    app_color_palette["アプリのカラーパレットの集約"]
    hardcoded_color["色のハードコード"]
    system_color_pairing["システムカラーの前景/背景ペア"]
    high_contrast_detection["コントラストテーマの検知API"]
    winforms_set_color_mode["WinFormsのApplication.SetColorMode"]
    winforms_apply_theming_implicitly["ControlStyles.ApplyThemingImplicitly"]
    owner_drawn_control["独自描画コントロール"]
    wpf_theme_mode["WPFのThemeMode(Fluentテーマ)"]
    wpf_resource_dictionary_swap["WPFのリソース辞書の差し替え"]
    wpf["WPF"]
    winui_theme_dictionaries["WinUIのThemeDictionaries"]
    contrast_theme_support["コントラストテーマ対応"]
    contrast_ratio["コントラスト比(達成基準1.4.3)"]
    light_fixed_policy["ライト固定の方針"]
    dotnet_framework[".NET Framework"]
    contrast_theme -->|"両立しない"| windows_color_mode
    dwmwa_use_immersive_dark_mode -->|"実装を担う"| dark_title_bar
    dark_title_bar -->|"で構成できる"| dwm_set_window_attribute
    dark_title_bar -->|"前提とする"| windows_color_mode
    dwmwa_use_immersive_dark_mode -->|"前提とする"| windows_11
    dwm_caption_color_attributes -->|"で構成できる"| dwm_set_window_attribute
    dwm_system_backdrop -->|"で構成できる"| dwm_set_window_attribute
    dwm_system_backdrop -->|"前提とする"| windows_11
    windows_color_mode -->|"で確認できる"| uisettings_color_values
    windows_color_mode -->|"に保存される"| apps_use_light_theme_registry
    theme_change_notification -->|"推奨される対応"| windows_color_mode
    theme_change_notification -->|"推奨される対応"| contrast_theme
    app_color_palette -->|"推奨される対応"| windows_color_mode
    hardcoded_color -->|"用いるのは非推奨"| contrast_theme
    hardcoded_color -->|"両立しない"| system_color_pairing
    system_color_pairing -->|"推奨される対応"| contrast_theme
    contrast_theme -->|"で確認できる"| high_contrast_detection
    winforms_set_color_mode -->|"実装を担う"| windows_color_mode
    winforms_set_color_mode -->|"前提とする"| windows_11
    winforms_set_color_mode -->|"両立しない"| contrast_theme
    winforms_apply_theming_implicitly -.->|"推奨される対応"| owner_drawn_control
    wpf_theme_mode -->|"実装を担う"| windows_color_mode
    wpf_theme_mode -->|"実装を担う"| dark_title_bar
    wpf_resource_dictionary_swap -.->|"推奨される対応"| wpf
    winui_theme_dictionaries -->|"実装を担う"| contrast_theme_support
    windows_color_mode -->|"前提とする"| contrast_ratio
    light_fixed_policy -.->|"推奨される対応"| dotnet_framework
    contrast_theme_support -->|"推奨される対応"| light_fixed_policy

概念間の関係(全28件)

図と同じ関係を文章でも列挙します。表示している文と機械可読な意味データ(RDFa)は同じ要素に載っています。確度が「確立した関係」のものは直接の関係として、「条件付きの関係」のものは成立条件つきの言明(rdf:Statement)として表現しています。

• コントラストテーマ(ハイコントラスト)はカラーモード(ライト/ダーク)と両立しません。コントラストテーマが有効な間はダークモードが使えない。WinFormsのSetColorModeはコントラストテーマ中はダークを提供せず、XAMLのRequestedThemeもシステムに上書きされる。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典 出典
• DWMWA_USE_IMMERSIVE_DARK_MODEはダークタイトルバーの実装を担います。値20にBOOLのTRUEを渡すと、ダークモードのシステム設定が有効なときにウィンドウのフレームをダークの色で描くことが許可される。TRUEは「ダークにしろ」ではなく「システムがダークならダークにしてよい」という許可。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典
• ダークタイトルバーはDwmSetWindowAttributeで構成できます。タイトルバーを含む非クライアント領域はDWMが描いており、アプリはDwmSetWindowAttributeをトップレベルウィンドウのHWNDに対して呼んで描き方を指示する。HWNDが生成されるたび(再生成を含む)に設定し直す。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典
• ダークタイトルバーはカラーモード(ライト/ダーク)を前提とします。属性をTRUEにしても、フレームがダークで描かれるのはシステムのカラーモードがダークのときだけで、ライトのときはライトで描かれる。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
• DWMWA_USE_IMMERSIVE_DARK_MODEはWindows 11を前提とします。文書化された対応はWindows 11 ビルド22000以降。それ未満のOSでは属性を呼ばずにライトのタイトルバーという文書化された既定に従い、対応OSでの失敗はHRESULTを記録して表面化させる。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
• DWMのタイトルバー色属性はDwmSetWindowAttributeで構成できます。DWMWA_BORDER_COLOR(34)・DWMWA_CAPTION_COLOR(35)・DWMWA_TEXT_COLOR(36)にCOLORREFを渡してタイトルバーの色・文字色・枠線色を指定し、DWMWA_COLOR_DEFAULTで既定に戻す。Windows 11 ビルド22000以降。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
• DWMのシステム背景素材(Mica/Acrylic)はDwmSetWindowAttributeで構成できます。DWMWA_SYSTEMBACKDROP_TYPE(38)にDWM_SYSTEMBACKDROP_TYPEの値を渡し、MicaやAcrylicに相当する背景素材をウィンドウ全体の背後に描かせる。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典
• DWMのシステム背景素材(Mica/Acrylic)はWindows 11を前提とします。DWMWA_SYSTEMBACKDROP_TYPEはWindows 11 ビルド22621以降で対応する。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典
• カラーモード(ライト/ダーク)はUISettingsによるカラーモードの取得と変更通知で確認できます。UISettings.GetColorValue(UIColorType.Foreground)で前景色を取り、知覚輝度の整数演算で明るいと判定されればダークモードとする。これがMicrosoftの公式手順で、変更はColorValuesChangedで追跡する。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典 出典
• カラーモード(ライト/ダーク)はAppsUseLightThemeレジストリ値に保存されます。カラーモードはHKCU\Software\Microsoft\Windows\CurrentVersion\Themes\PersonalizeのAppsUseLightTheme(アプリ)とSystemUsesLightTheme(Windows)に保存される。レジストリは保存場所であってAPI契約ではないので、読むならUISettingsを正とする。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
• テーマ変更の通知はカラーモード(ライト/ダーク)に対する本記事の推奨です。実行中の切り替えに追従するには、ColorValuesChangedやWM_SETTINGCHANGE(.NETではUserPreferenceChanged)を購読し、どの通知が来ても同じ「読んで塗り直す」処理を呼ぶ。ColorValuesChangedはUIスレッドで届く保証がないためUIへ戻してから塗り直す。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典 出典
• テーマ変更の通知はコントラストテーマ(ハイコントラスト)に対する本記事の推奨です。初期化時とWM_SYSCOLORCHANGE処理時にハイコントラストの状態を判定し直し、テーマ変更時はWM_THEMECHANGEDで色を再計算して再描画する。.NETではUserPreferenceChangedで同じことを行う。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典 出典
• アプリのカラーパレットの集約はカラーモード(ライト/ダーク)に対する本記事の推奨です。ダークモードを完全にサポートするにはアプリのサーフェス全体がダークに従う必要があり、塗り直すには色が一箇所(ライト用とダーク用のパレット)に集まっていなければならない。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
• 色のハードコードをコントラストテーマ(ハイコントラスト)に用いることは推奨されません。背景だけを#E6E6E6のように固定すると、コントラストテーマでは前景が白になって読めなくなる。文字色もハードコードせず、ユーザーが色を編集するため適用中のテーマに依存しないUIにする。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典
• 色のハードコードはシステムカラーの前景/背景ペアと両立しません。黒い文字を前提にしてシステムの選択色を使うと、High Contrast Blackでは選択色が黒になり黒地に黒文字になる。ハードコードした色とシステムカラーを混ぜると前景と背景のペアが崩れる。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典
• システムカラーの前景/背景ペアはコントラストテーマ(ハイコントラスト)に対する本記事の推奨です。ハイコントラストが有効なときは、すべての色をCOLOR_WINDOWTEXTとCOLOR_WINDOW、またはCOLOR_BTNTEXTとCOLOR_BTNFACEのような前景と背景の1組に写像し、文字の背後の画像を省き、多色の画像を前景色と背景色で描く。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典
• コントラストテーマ(ハイコントラスト)はコントラストテーマの検知APIで確認できます。SystemParametersInfoにSPI_GETHIGHCONTRASTを渡してHCF_HIGHCONTRASTONを確認するのが唯一のサポートされた判定方法で、WinFormsのSystemInformation.HighContrast、WPFのSystemParameters.HighContrast、WinUI 3のThemeSettings.HighContrastはこれを包んでいる。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典 出典 出典
• WinFormsのApplication.SetColorModeはカラーモード(ライト/ダーク)の実装を担います。Application.SetColorMode(SystemColorMode.System)をApplication.Runの前に呼ぶとWindowsのライト/ダーク設定に従い、SystemColorsが対応する色セットに切り替わって標準コントロールが従う。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典
• WinFormsのApplication.SetColorModeはWindows 11を前提とします。ダークのカラーモードはWindows 11以降でのみ利用できる。また、Systemを指定しても実行中にWindowsの設定が変わったときにアプリは自動では追従しない。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
• WinFormsのApplication.SetColorModeはコントラストテーマ(ハイコントラスト)と両立しません。システムがハイコントラストモードのときはダークモードは利用できない。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
• ControlStyles.ApplyThemingImplicitlyは独自描画コントロールに対する本記事の推奨です。自分で構成・描画するコントロールの中でスクロールバーなどのWin32コモンコントロールを使う場合、CreateParamsのオーバーライド内でbase.CreateParamsより前にSetStyle(ControlStyles.ApplyThemingImplicitly, true)を呼んでオプトインしないとライトのまま残る。 / 確度: 条件付きの関係 / 確認日: 2026-09-02 出典
• WPFのThemeMode(Fluentテーマ)はカラーモード(ライト/ダーク)の実装を担います。ThemeMode="System"を設定するとWindowsの設定に応じたライトまたはダークのFluentテーマが読み込まれる。コードからの設定は.NET 10でも実験的(WPF0001)。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典
• WPFのThemeMode(Fluentテーマ)はダークタイトルバーの実装を担います。ThemeModeはFluentテーマの辞書を読み込むだけでなく、ウィンドウへの背景素材とダークモードの適用も制御するため、DWM属性の設定はWPF側が引き受ける。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
• WPFのリソース辞書の差し替えはWPFに対する本記事の推奨です。Fluentを採用しないWPFや.NET 8以前・.NET FrameworkのWPFでは、ライト用とダーク用の辞書に同じキーで色を定義し、DynamicResourceで参照し、MergedDictionariesで入れ替えて追従させる。 / 確度: 条件付きの関係 / 確認日: 2026-09-02 出典 出典
• WinUIのThemeDictionariesはコントラストテーマ対応の実装を担います。WinUIではResourceDictionary.ThemeDictionariesにHighContrastキーの辞書を用意し、色をハードコードせずSystemColorWindowColorのような動的なシステムカラーをThemeResourceで参照する。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典
• カラーモード(ライト/ダーク)はコントラスト比(達成基準1.4.3)を前提とします。ダークのパレットにもテキスト4.5:1・大きな文字3:1というコントラスト比の基準は同じように適用され、暗い灰色の背景に中間の灰色の文字を置くデザインはライトの「白地に薄い灰色」と同じ問題を抱える。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典
• ライト固定の方針は.NET Frameworkに対する本記事の推奨です。SetColorModeが無い.NET Frameworkや.NET 8以前のWinFormsでは、コモンコントロールの描画をアプリが完全には制御できず中途半端なダークになりがちなので、ライト固定を明示し、.NET 10へ移行するタイミングでSetColorModeに切り替える。 / 確度: 条件付きの関係 / 確認日: 2026-09-02 出典 出典
• コントラストテーマ対応はライト固定の方針に対する本記事の推奨です。ライト固定を選んでも、コントラストテーマ対応だけは固定できない。テーマの好みではなく使えるかどうかの問題で、合理的配慮の領域に当たる。 / 確度: 確立した関係 / 確認日: 2026-09-02 出典 出典

主要概念の定義

カラーモード(ライト/ダーク)

Windowsの「設定 > 個人用設定 > 色」で選ぶ、OSとアプリ全体の前景色と背景色の明暗を定める設定。ライトは明るい背景に暗い前景、ダークは暗い背景に明るい前景で、前景とは既定の文字色を指す。

コントラストテーマ(ハイコントラスト)

おおむね7:1以上のコントラスト比の制約されたパレットを使うWindowsのテーマ。

DWMWA_USE_IMMERSIVE_DARK_MODE

DwmSetWindowAttributeで使うDWMWINDOWATTRIBUTEの値20。BOOLのTRUEを渡すと、ダークモードのシステム設定が有効なときにウィンドウのフレームをダークの色で描くことを許可し、FALSEで常にライトになる。Windows 11 ビルド22000以降で対応。

ダークタイトルバー

システムのダーク設定に合わせて、DWMがウィンドウのフレーム(タイトルバー・枠)をダークの色で描く状態。Windowsはアプリの対応可否を知らないため、互換性のためすべてのウィンドウが既定でライトになる。

DWMのタイトルバー色属性

タイトルバーの色(35)・タイトル文字の色(36)・ウィンドウ枠の色(34)をCOLORREFで指定するDWMWINDOWATTRIBUTEの値。DWMWA_COLOR_DEFAULTを渡すとシステム既定に戻る。Windows 11 ビルド22000以降で対応。

DWMのシステム背景素材(Mica/Acrylic)

DWMWA_SYSTEMBACKDROP_TYPE(38)でウィンドウ全体の背後にシステムが描く素材を指定する仕組み。Windows 11ではDWMSBT_MAINWINDOWがMica、DWMSBT_TRANSIENTWINDOWがAcrylicに相当し、素材の効果は将来のWindowsで変わりうる。ビルド22621以降で対応。

テーマ変更の通知

システム設定・テーマ・システムカラーの変更をアプリに知らせるWin32メッセージ(WM_SETTINGCHANGE・WM_THEMECHANGED・WM_SYSCOLORCHANGE)と、.NETでそれを包むSystemEvents.UserPreferenceChangedイベント。

アプリのカラーパレットの集約

アプリが使う色をライト用・ダーク用の1組ずつにまとめ、各画面がそこから色を取る構造。散らばったハードコード色では塗り直す場所を列挙できない。

色のハードコード

Color.Whiteや#E6E6E6のように特定の色をコードやXAMLに直接書くこと。テーマやコントラストテーマの切り替えに追従できず、前景と背景の組み合わせを崩す原因になる。

システムカラーの前景/背景ペア

WindowTextとWindow、ButtonTextとButtonFace、HighlightTextとHighlight、GrayTextとWindow、HotlightとWindowのように、組み合わせて使う前提で設計されたシステムカラーの対応関係。GrayTextは無効状態、Hotlightはハイパーリンク専用。

WinFormsのApplication.SetColorMode

.NET 9で導入され.NET 10で実験的でなくなった、WinFormsアプリのカラーモード(Classic・System・Dark)を設定するAPI。Application.Runより前に呼び、SystemColorsが対応する色セットに切り替わる。

ControlStyles.ApplyThemingImplicitly

WinFormsのコントロールがアプリのカラーモードに暗黙に従うかを決めるControlStyles。CreateParamsのオーバーライド内でbase.CreateParamsより前にSetStyleで設定する必要があり、コンストラクターでは間に合わない。

WPFのThemeMode(Fluentテーマ)

.NET 9のWPFで導入された、Windows 11のFluentデザインに沿ったテーマをLight・Dark・System・Noneのモードで適用するプロパティ。ウィンドウへのダークモードと背景素材の適用も制御する。コードからの操作は実験的(WPF0001)。

WPFのリソース辞書の差し替え

ライト用とダーク用のResourceDictionaryに同じキーで色を定義し、MergedDictionaries内で入れ替えることでDynamicResource参照を更新させる、従来テーマのWPFでテーマに追従する手法。StaticResource参照は読み込み時の値のまま更新されない。

WinUIのThemeDictionaries

XAMLのResourceDictionary.ThemeDictionariesにDefault・Light・HighContrastのキーでテーマごとのリソースを定義し、現在のテーマに応じて自動的に選ばれる仕組み。HighContrastは名前付きハイコントラストテーマが無いときのフォールバックキー。

ライト固定の方針

ダークモードの標準サポートが無いランタイムで、DWM属性を既定(FALSE)のままにしクライアント領域も従来どおりライトで一貫させると明示する方針。Windowsの既定の挙動そのもので、コントラストテーマ対応は別途必要。

コントラストテーマ対応

SystemColor/Brushリソースを使って色をハードコードせず、文字拡大時にはコントロールやコンテナもリサイズ・再配置されるようにする実装。4種類のコントラストテーマで動作確認することが推奨される。

機械可読データ

• JSON-LD / Turtle ── この記事の知識グラフ全体
• 概念一覧 / 語彙(述語)の定義

このデータセットについて

作成

合同会社小村ソフト

ライセンス

CC BY 4.0 ── 出典(合同会社小村ソフト)とライセンスへのリンクを明示し、改変した場合はその旨を示すことを条件に、再配布・改変を含めて再利用できます

最終確認日

2026-09-02 ── 収録する関係のうち、最後に出典と照合した日

このページはサイトの知識グラフ(_data/knowledge/)から自動生成されています。誤りの指摘はお問い合わせからお願いします。