OpenThemeDataForDpi 函式 (uxtheme.h)

OpenThemeData 的變體，開啟與特定 DPI 相關聯的主題句柄。

語法

HTHEME OpenThemeDataForDpi(
  HWND    hwnd,
  LPCWSTR pszClassList,
  UINT    dpi
);

hwnd

需要主題數據的視窗句柄。

pszClassList

字串的指標，其中包含類別的分號分隔清單。

dpi

要與主題句柄建立關聯的指定 DPI 值。如果此值不在對應至連線監視器集的值之外，函式會傳回錯誤。

當搭配 Per Monitor v2 視窗使用時，OpenThemeData 會建立與視窗 DPI 相關聯的主題句柄。 OpenThemeDataForDpi 可讓您在沒有該 DPI 視窗時，開啟特定 DPI 的主題句柄。

如果要求的 DPI 值未對應至目前連接的顯示器，傳回的主題句柄行為將會受到影響。主題系統只會載入與目前連線顯示器對應的一組 DPI 值的主題資產。

每當系統重載主題數據時，主題句柄就會變成無效。應用程式必須監視 WM_THEMECHANGED ，並關閉並重新開啟回應中的所有主題句柄。不論句柄是透過OpenThemeData還是OpenThemeDataForDpi開啟，此行為都相同。