OpenThemeDataForDpi 函数 (uxtheme.h)

OpenThemeData 的变体,可打开与特定 DPI 关联的主题句柄。

语法

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

参数

hwnd

需要主题数据的窗口的句柄。

pszClassList

指向包含以分号分隔的类列表的字符串的指针。

dpi

要与之关联的主题句柄的指定 DPI 值。 如果此值在与连接的监视器集对应的值之外,函数将返回错误。

返回值

请参阅 OpenThemeData

注解

当与 Per Monitor v2 窗口一起使用时,OpenThemeData 将创建与窗口的 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

另请参阅

OpenThemeData