GetThemeTextExtent 函数 (uxtheme.h)

计算以视觉样式字体呈现时指定文本的大小和位置。

语法

HRESULT GetThemeTextExtent(
  [in]  HTHEME  hTheme,
  [in]  HDC     hdc,
  [in]  int     iPartId,
  [in]  int     iStateId,
  [in]  LPCWSTR pszText,
  [in]  int     cchCharCount,
  [in]  DWORD   dwTextFlags,
  [in]  LPCRECT pBoundingRect,
  [out] LPRECT  pExtentRect
);

参数

[in] hTheme

类型： HTHEME

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

[in] hdc

类型： HDC

要选择其字体的 HDC。

[in] iPartId

类型： int

int 类型的值，指定要在其中绘制文本的部分。 请参阅 部件和状态。

[in] iStateId

类型： int

int 类型的值，指定部件的状态。 请参阅 部件和状态。

[in] pszText

类型： LPCWSTR

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

[in] cchCharCount

类型： int

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

[in] dwTextFlags

类型： DWORD

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

[in] pBoundingRect

类型： LPCRECT

指向 RECT 结构的指针，该结构包含用于控制文本布局的矩形。 此参数可能设置为 NULL。

[out] pExtentRect

类型： LPRECT

指向 RECT 结构的指针，该结构以逻辑坐标包含拟合呈现文本所需的矩形。

返回值

类型： HRESULT

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

要求

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

另请参阅

属性标识符