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 |