Seaside Laboratory

プログラムから設定

Windows Vista で追加された SetProcessDPIAware 関数を呼び出すことで、高 DPI に対応していることを宣言できる。ただ、Note に、

It is recommended that you set the process-default DPI awareness via application manifest, not an API call. See Setting the default DPI awareness for a process for more information. Setting the process-default DPI awareness via API call can lead to unexpected application behavior.

API 呼び出しではなくアプリケーションマニフェストを介してプロセスの既定 DPI 認識を設定することをお勧めします。詳細については「プロセスの既定 DPI 認識の設定」を参照してください。API 呼び出しを介してプロセスの既定 DPI 認識を設定すると、アプリケーションが予期しない動作をする可能性があります。

と書かれているように API による DPI 認識設定は推奨されていない。

また、SetProcessDPIAware 関数とマニフェストの関係については、PDC 2008 の資料に詳しく書かれている。

アプリケーションのアセンブリマニフェストに <dpiAware> 要素を追加することにより、アプリケーションが DPI 対応であることを宣言できます。user32.dll モジュール (Windows のユーザーインターフェイス機能を提供するモジュール) によって、アプリケーションの DPI 対応性設定がチェックされます。アプリケーションが DPI 対応であることが判明すると、アプリケーションの代わりに user32.dll モジュールが SetProcessDPIAware 関数を呼び出します。

アプリケーションマニフェスト

Visual Studio でビルドしたアプリケーションにはマニフェストが自動的に埋め込まれる。以下は実行ファイルから抜き出したもの。

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
    <security>
      <requestedPrivileges>
        <requestedExecutionLevel level="asInvoker" uiAccess="false" />
      </requestedPrivileges>
    </security>
  </trustInfo>
</assembly>

マニフェストの設定は manifest ファイルをリソースとして埋め込んだり、ツールを使って後から追加したりと様々な方法が用意されているが、マニフェストの書式は複雑なのでプロジェクト設定を変更してやるのが一番手っ取り早い。[構成プロパティ]>[マニフェストツール]>[入出力] にある「DPI 認識」を「高い DPI 認識」に設定すると、

<?xml version="1.0" encoding="UTF-8" standalone="yes"?>
<assembly xmlns="urn:schemas-microsoft-com:asm.v1" manifestVersion="1.0">
  <trustInfo xmlns="urn:schemas-microsoft-com:asm.v3">
    <security>
      <requestedPrivileges>
        <requestedExecutionLevel level="asInvoker" uiAccess="false"></requestedExecutionLevel>
      </requestedPrivileges>
    </security>
  </trustInfo>
  <application xmlns="urn:schemas-microsoft-com:asm.v3">
    <windowsSettings>
      <dpiAware xmlns="http://schemas.microsoft.com/SMI/2005/WindowsSettings">true</dpiAware>
    </windowsSettings>
  </application>
</assembly>

dpiAware 要素が追加される。

設定値「高い DPI 認識」は、DPI 認識モードにおける「システム DPI 対応」のことを指していて、詳細については「High DPI Desktop Application Development on Windows」に書かれている。

Desktop applications that are system DPI aware typically receive the DPI of the primary connected monitor as of the time of user sign-in. During initialization, they lay out their UI appropriately (sizing controls, choosing font sizes, loading assets, etc.) using that System DPI value. As such, System DPI-aware applications are not DPI scaled (bitmap stretched) by Windows on displays rendering at that single DPI. When the application is moved to a display with a different scale factor, or if the display scale factor otherwise changes, Windows will bitmap scale the application's windows, making them appear blurry. Effectively, System DPI-aware desktop applications only render crisply at a single display scale factor, becoming blurry whenever the DPI changes.

システム DPI 対応のデスクトップアプリケーションは、通常、ユーザーがサインインした時に接続されているプライマリモニターの DPI を受け取ります。初期化中、そのシステム DPI 値を使用して UI を適切にレイアウトします (コントロールのサイズ変更、フォントサイズの選択、アセットの読み込みなど)。そのためシステム DPI 対応アプリケーションは、その単一 DPI で表示されるディスプレイ上では Windows によって DPI スケーリング (ビットマップストレッチ) されません。アプリケーションがスケールファクターの異なるディスプレイに移動した場合、またはスケールファクターが変更された場合、アプリケーションのウィンドウは Windows によってビットマップスケールされ、ぼやけた表示になります。事実上、システム DPI 対応のデスクトップアプリケーションは単一のスケールファクターでのみ鮮明に表示され、DPI が変化する度にぼやけてしまいます。