TextRange_GetText 函数 (uiautomationcoreapi.h)

注意 此函数已弃用。 客户端应用程序应改用 Microsoft UI 自动化 组件对象模型 (COM) 接口。
 
返回文本范围中的文本,最多包含指定数量的字符。

语法

HRESULT TextRange_GetText(
  [in]  HUIATEXTRANGE hobj,
  [in]  int           maxLength,
  [out] BSTR          *pRetVal
);

参数

[in] hobj

类型: HUIATEXTRANGE

文本范围对象。

[in] maxLength

类型: int

要返回的字符数,从文本范围的起始端点处的字符开始。

[out] pRetVal

类型: BSTR*

当此函数返回时,此参数包含指向返回的文本的指针。 此参数未经初始化即被传递。

返回值

类型: HRESULT

如果成功,则返回S_OK,否则返回错误值。

注解

如果 maxLength 为 -1,则返回文本范围内的所有文本。 如果 maxLength 大于文本范围的长度,则返回的字符串将包含文本范围中的所有文本。

要求

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