¶ モダンな (.NET 5.0 以降の)
WinForms 開発
新機能：「ダークモード」対応
¶ .NET 9.0 ~
ダークモードを標準サポート
ついに Windows Forms にも標準で ダークモード が、.NET 9 以降から徐々に対応され始め、正式には .NET 10 からのサポートとなりました。
設定は極めて容易で、Program.cs 内で Application.SetColorMode() メソッド、この1行を呼び出すだけです。
Application.SetColorMode(SystemColorMode.Dark);
¶ 第1引数: SystemColorMode
第1引数へデフォルトのカラーモードとして、以下の3つのいずれかを設定することができます。
¶ Classic = 0
※初期設定値。
従来の、レガシーな Windows Forms のカラーモード（ライトモード）になります。
Application.SetColorMode(SystemColorMode.Classic);
¶ System = 1
ユーザーが設定している、「個人用設定」→「テーマ」→「色」の「モード」で設定しているカラーモードに応じて、ライトモード か ダークモード か、が自動で適応されます。
Application.SetColorMode(SystemColorMode.System);
上の設定に応じて
または
¶ Dark = 2
新たにサポートされた、ダークモードになります。
Application.SetColorMode(SystemColorMode.Dark);
¶ 留意点
- 当然のことながら、レガシーな .NET Framework の WinForms では使えません。モダンな .NET の 9 以降で使うことができます。
- ダークモードは、Windows 11 以降でのみ有効です。
- Windows にて、視覚補助設定の「ハイコントラストモード」を有効にしている場合は、Windows の設定側でダークモードにしていて、かつ
SystemColorMode.Darkをセットしていたとしても、 WinForms アプリに今回の新たなダークテーマは適用されません。 - .NET 10 までの場合、あくまで WinForms アプリ起動時のデフォルトカラーモードの設定であり、アプリ起動後に Windows 設定から、システムカラーを、ライトからダーク、もしくはダークからライトへと変更したときの挙動としては
SystemColorMode.Systemをセットしていたとしても、自動的にはカラーモードが変わらないです。
¶ ref. 公式ドキュメント
- Microsoft Learn .NET / API / System.Windows.Forms 名前空間 / Application クラス / SetColorMode(SystemColorMode) メソッド
- Microsoft Learn .NET / API / System.Windows.Forms 名前空間 / SystemColorMode 列挙型
{
pages {
search (query: "TechMemo/DotNet/WinForms/modernWinForms") {
results {
id
path
title
}
}
}
}