DrawThemeTextEx 函数 (uxtheme.h)

使用视觉样式定义的颜色和字体绘制文本。 通过允许其他文本格式选项扩展 DrawThemeText 。

语法

HRESULT DrawThemeTextEx(
  [in]      HTHEME        hTheme,
  [in]      HDC           hdc,
  [in]      int           iPartId,
  [in]      int           iStateId,
  [in]      LPCWSTR       pszText,
  [in]      int           cchText,
  [in]      DWORD         dwTextFlags,
  [in, out] LPRECT        pRect,
  [in]      const DTTOPTS *pOptions
);

参数

[in] hTheme

类型： HTHEME

窗口的指定主题数据的句柄。 使用 OpenThemeData 创建 HTHEME。

[in] hdc

类型： HDC

用于绘图的 HDC。

[in] iPartId

类型： int

具有所需文本外观的控件部件。 请参阅 部件和状态。 如果此值为 0，则会使用默认字体或在设备上下文中选择的字体绘制文本。

[in] iStateId

类型： int

具有所需文本外观的控件状态。 请参阅 部件和状态。

[in] pszText

类型： LPCWSTR

指向包含要绘制的文本的字符串的指针。

[in] cchText

类型： int

包含要绘制的字符数的 int 类型的值。 如果 参数设置为 -1，则绘制字符串中的所有字符。

[in] dwTextFlags

类型： DWORD

包含指定字符串格式的一个或多个值的 DWORD。 有关可能的参数值，请参阅 设置值格式 。

[in, out] pRect

类型： LPRECT

指向 RECT 结构的指针，该结构包含要在其中绘制文本的逻辑坐标矩形。

[in] pOptions

类型： const DTTOPTS*

一种 DTTOPTS 结构，用于定义将应用于所绘制文本的其他格式设置选项。

返回值

类型： HRESULT

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

注解

函数始终使用指定部分和状态（如果已定义）主题字体。 否则，它将使用当前在设备上下文中选择的字体。 若要确定是否定义了主题字体，可以使用 TMT_FONT 作为属性标识符调用 GetThemeFont 或 GetThemePropertyOrigin 。

要求

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