OpenThemeDataForDpi 関数 (uxtheme.h)
特定の DPI に関連付けられたテーマ ハンドルを開く OpenThemeData のバリアント。
構文
HTHEME OpenThemeDataForDpi(
HWND hwnd,
LPCWSTR pszClassList,
UINT dpi
);
パラメーター
hwnd
テーマ データが必要なウィンドウのハンドル。
pszClassList
クラスのセミコロン区切りのリストを含む文字列へのポインター。
dpi
テーマ ハンドルを関連付ける指定された DPI 値。 この値が接続されているモニターのセットに対応する値の外部にある場合、関数はエラーを返します。
戻り値
「OpenThemeData」を参照してください。
注釈
OpenThemeData では、Per Monitor v2 ウィンドウで使用すると、ウィンドウの DPI に関連付けられたテーマ ハンドルが作成されます。 OpenThemeDataForDpi を使用すると、その DPI にウィンドウがない場合に、特定の DPI のテーマ ハンドルを開きます。
要求された DPI 値が現在接続されているディスプレイに対応していない場合、返されるテーマ ハンドルの動作は損なわれます。 テーマ システムは、 現在接続されている ディスプレイに対応する DPI 値のセットのテーマ アセットのみを読み込みます。
テーマ ハンドルは、システムがテーマ データを再読み込みするたびに無効になります。 アプリケーションは、 WM_THEMECHANGED を監視し、応答ですべてのテーマ ハンドルを閉じて再度開く必要があります。 この動作は、ハンドルが OpenThemeData または OpenThemeDataForDpi を介して開かれたかどうかに関係なく同じです。
要件
| 要件 | 値 |
|---|---|
| サポートされている最小のクライアント | Windows 10バージョン 1703 [デスクトップ アプリのみ] |
| サポートされている最小のサーバー | Windows Server 2016 [デスクトップ アプリのみ] |
| 対象プラットフォーム | Windows |
| ヘッダー | uxtheme.h |
| Library | uxtheme.lib |
| [DLL] | uxtheme.dll |