指定したウィンドウの 1 インチあたりのドット数 (dpi) の値を返します。
構文
UINT GetDpiForWindow(
[in] HWND hwnd
);
パラメーター
[in] hwnd
情報を取得するウィンドウ。
戻り値
ウィンドウの DPI。ウィンドウの DPI_AWARENESS によって異なります。 詳細については、「解説」セクションを参照してください。 無効な hwnd 値を指定すると、戻り値は 0 になります。
注釈
次の表は、指定された hwnd のDPI_AWARENESSに基づく GetDpiForWindow の戻り値を示しています。
| DPI_AWARENESS | 戻り値 |
|---|---|
| DPI_AWARENESS_UNAWARE | DPI の基本値は、96 ('USER_DEFAULT_SCREEN_DPI' として定義) に設定されています。 |
| DPI_AWARENESS_SYSTEM_AWARE | システム DPI。 |
| DPI_AWARENESS_PER_MONITOR_AWARE | ウィンドウが配置されているモニターの DPI。 |
例
「単純な Direct2D アプリケーションを作成する」を参照してください。
要件
| サポートされている最小のクライアント | Windows 10、バージョン 1607 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | winuser.h (Windows.h を含む) |
| Library | User32.lib |
| [DLL] | User32.dll |