OpenThemeDataForDpi

特定の DPI に関連付けられたテーマハンドルを開く OpenThemeData の派生関数。

OpenThemeDataForDpi hwnd, pszClassList, dpi

hwnd : [intptr] テーマデータが必要なウィンドウのハンドル。
pszClassList : [wstr] セミコロンで区切られたクラスのリストを含む文字列へのポインター。
dpi : [int] テーマハンドルに関連付ける指定された DPI 値。この値が接続されているモニターに対応する値の集合外である場合、関数はエラーを返す。

(プラグイン / モジュール : uxtheme.dll)

解説

特定の DPI に関連付けられたテーマハンドルを開く OpenThemeData の派生関数。

[戻り値]
OpenThemeData を参照。

[備考]
OpenThemeData は、Per Monitor v2 ウィンドウとともに使用された場合に、ウィンドウの DPI
に関連付けられたテーマハンドルを作成する。OpenThemeDataForDpi は、その DPI
のウィンドウを持っていない場合に、特定の DPI に対するテーマハンドルを開けるようにする。要求された DPI
値が現在接続されているディスプレイに対応していない場合、返されるテーマハンドルの動作は不定となる。テーマシステムは、現在接続されているディスプレイに対応する
DPI
値の集合に対してのみテーマアセットをロードする。テーマハンドルは、システムがテーマデータを再ロードするたびに無効となる。アプリケーションは
WM_THEMECHANGED を監視し、それに応じてすべてのテーマハンドルを閉じて再オープンする必要がある。この動作は、ハンドルが
OpenThemeData で開かれたか OpenThemeDataForDpi で開かれたかにかかわらず同じである。

情報