GetThemeSysString 函数 (uxtheme.h)

检索系统字符串的值。

语法

HRESULT GetThemeSysString(
  [in]  HTHEME hTheme,
  [in]  int    iStringId,
  [out] LPWSTR pszStringBuff,
  [in]  int    cchMaxStringChars
);

参数

[in] hTheme

类型: HTHEME

主题数据的句柄。

[in] iStringId

类型: int

指定系统字符串的 int 类型的值。 可以是以下值之一。

含义
TMT_CSSNAME
hTheme 指定的主题关联的 CSS 文件的名称。
TMT_XMLNAME
hTheme 指定的主题关联的 XML 文件的名称。

[out] pszStringBuff

类型: LPWSTR

指向从此函数接收字符串值的缓冲区的指针。

[in] cchMaxStringChars

类型: int

int 类型的值,该值指定字符串缓冲区可以容纳的最大字符数。

返回值

类型: HRESULT

如果此函数成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

如果主题数据句柄不是 NULL 句柄,此函数将从视觉样式的 SysMetrics 部分返回所需的字符串。 如果主题数据句柄为 NULL,则此函数返回相同类型的全局系统指标的值。

要求

要求
最低受支持的客户端 Windows Vista [仅限桌面应用]
最低受支持的服务器 Windows Server 2003 [仅限桌面应用]
目标平台 Windows
标头 uxtheme.h
Library UxTheme.lib
DLL UxTheme.dll