Windows フォームでの高 DPI サポート

[アーティクル]
2025-05-07

.NET Framework 4.7 以降、Windows フォームには、一般的な高 DPI および動的 DPI シナリオの機能強化が含まれています。これらには次のものが含まれます。

MonthCalendar コントロールや CheckedListBox コントロールなど、多数の Windows フォームコントロールのスケーリングとレイアウトが改善されました。
シングルパスの拡大縮小。 .NET Framework 4.6 以前のバージョンでは、スケーリングは複数のパスを通じて実行され、一部のコントロールは必要以上にスケーリングされていました。
Windows フォームアプリケーションの起動後にユーザーが DPI またはスケールファクターを変更する動的 DPI シナリオのサポート。

.NET Framework 4.7 以降のバージョンの .NET Framework では、拡張高 DPI サポートがオプトイン機能です。アプリケーションが（それを）活用できるように構成する必要があります。

高 DPI サポート用の Windows フォームアプリの構成

重要

この情報は .NET Framework にのみ適用されます。 .NET で高 DPI のサポートを有効にするには、プロジェクトレベルのアプリケーション設定を参照してください。

高 DPI 対応をサポートする新しい Windows フォーム機能は、.NET Framework 4.7 を対象とし、Windows 10 Creators Update 以降の Windows オペレーティングシステムで実行されているアプリケーションでのみ使用できます。

さらに、Windows フォームアプリケーションで高 DPI サポートを構成するには、次の操作を行う必要があります。

Windows 10 との互換性を宣言します。

これを行うには、マニフェストファイルに次のコードを追加します。

<compatibility xmlns="urn:schemas-microsoft-com:compatibility.v1">
  <application>
    <!-- Windows 10 compatibility -->
    <supportedOS Id="{8e0f7a12-bfb3-4fe8-b9a5-48fd50a15a9a}" />
  </application>
</compatibility>

app.config ファイルでモニターごとの DPI 認識を有効にします。

Windows フォームには、.NET Framework 4.7 以降で追加された新機能とカスタマイズをサポートする新しい <System.Windows.Forms.ApplicationConfigurationSection> 要素が導入されています。高 DPI をサポートする新機能を利用するには、アプリケーション構成ファイルに以下を追加します。
```
<configuration>
  

  <System.Windows.Forms.ApplicationConfigurationSection>
    <add key="DpiAwareness" value="PerMonitorV2" />
  </System.Windows.Forms.ApplicationConfigurationSection>

</configuration>
```
重要

以前のバージョンの .NET Framework では、マニフェストを使用して高 DPI のサポートを追加しました。この方法は、app.config ファイルで定義されている設定をオーバーライドするため、推奨されなくなりました。
静的 EnableVisualStyles メソッドを呼び出します。

これは、アプリケーションエントリポイントの最初のメソッド呼び出しである必要があります。例えば次が挙げられます。
```
static void Main()
{
    Application.EnableVisualStyles();
    Application.SetCompatibleTextRenderingDefault(false);
    Application.Run(new Form2());
}
```

個々の高 DPI 機能のオプトアウト

重要

DpiAwareness 値を PerMonitorV2 に設定すると、.NET Framework 4.7 以降の .NET Framework バージョンでサポートされているすべての高 DPI 認識機能が有効になります。通常、これはほとんどの Windows フォームアプリケーションに適しています。ただし、1 つ以上の個別の機能をオプトアウトすることもできます。これを行う最も重要な理由は、既存のアプリケーションコードがその機能を既に処理していることです。たとえば、アプリケーションが自動スケーリングを処理する場合は、次のように自動サイズ変更機能を無効にすることができます。

<configuration>
  <!-- ... other xml settings ... -->

  <System.Windows.Forms.ApplicationConfigurationSection>
    <add key="DpiAwareness" value="PerMonitorV2" />
    <add key="EnableWindowsFormsHighDpiAutoResizing" value="false" />
  </System.Windows.Forms.ApplicationConfigurationSection>

</configuration>

個々のキーとその値の一覧については、「Windows フォームの構成要素の追加」を参照してください。

新しい DPI 変更イベント

.NET Framework 4.7 以降では、3 つの新しいイベントを使用して、動的 DPI 変更をプログラムで処理できます。

DpiChangedAfterParent は、コントロールの DPI 設定がプログラムによって変更されたときに、親コントロールまたはフォームの DPI 変更イベントが発生した後で生成されます。
DpiChangedBeforeParent:親コントロールまたはフォームの DPI 変更イベントが発生する前に、コントロールの DPI 設定がプログラムによって変更されたときに発生します。
DpiChanged:フォームが現在表示されているディスプレイデバイスで DPI 設定が変更されたときに発生します。

新しいヘルパーメソッドとプロパティ

.NET Framework 4.7 には、DPI スケーリングに関する情報を提供し、DPI スケーリングを実行できる新しいヘルパーメソッドとプロパティも多数追加されています。これらには次のものが含まれます。

LogicalToDeviceUnits。値を論理ピクセルからデバイスピクセルに変換します。
ScaleBitmapLogicalToDevice:ビットマップイメージをデバイスの論理 DPI にスケーリングします。
DeviceDpi。現在のデバイスの DPI を返します。

バージョン管理に関する考慮事項

.NET Framework 4.7 および Windows 10 Creators Update で実行するだけでなく、高 DPI の機能強化と互換性のない環境でアプリケーションを実行することもできます。この場合は、アプリケーションのフォールバックを開発する必要があります。拡大縮小を処理するカスタム描画を実行することで、これを行うことができます。

これを行うには、アプリが実行されているオペレーティングシステムも決定する必要があります。これを行うには、次のようなコードを使用します。

// Create a reference to the OS version of Windows 10 Creators Update.
Version OsMinVersion = new Version(10, 0, 15063, 0);

// Access the platform/version of the current OS.
Console.WriteLine(Environment.OSVersion.Platform.ToString());
Console.WriteLine(Environment.OSVersion.VersionString);

// Compare the current version to the minimum required version.
Console.WriteLine(Environment.OSVersion.Version.CompareTo(OsMinVersion));

サポートされているオペレーティングシステムとしてアプリケーションマニフェストに表示されていない場合、アプリケーションは Windows 10 を正常に検出できないことに注意してください。

アプリケーションがビルドされた .NET Framework のバージョンを確認することもできます。

Console.WriteLine(AppDomain.CurrentDomain.SetupInformation.TargetFrameworkName);

次の方法で共有

Windows フォームでの高 DPI サポート

高 DPI サポート用の Windows フォーム アプリの構成

個々の高 DPI 機能のオプトアウト

新しい DPI 変更イベント

新しいヘルパー メソッドとプロパティ

バージョン管理に関する考慮事項

こちらも参照ください

その他のリソース

高 DPI サポート用の Windows フォームアプリの構成

新しいヘルパーメソッドとプロパティ