iTextRangeProvider::GetText 方法 (uiautomationcore.h)

检索文本范围的纯文本。

语法

HRESULT GetText(
  [in]          int  maxLength,
  [out, retval] BSTR *pRetVal
);

参数

[in] maxLength

类型: int

要返回的字符串的最大长度。 如果没有任何限制,则使用 -1。

[out, retval] pRetVal

类型: BSTR*

接收文本范围的纯文本,可能以指定的最大长度截断。 此参数未经初始化即被传递。

返回值

类型: HRESULT

如果该方法成功,则返回 S_OK。 否则,将返回 HRESULT 错误代码。

注解

ITextRangeProvider::GetText 检索隐藏文本和可见文本。

如果 maxLength 大于调用方的文本范围的长度,则返回的字符串将是文本范围的纯文本。

ITextRangeProvider::GetText 不受文本流中终结点的顺序的影响;它将始终返回逻辑文本流顺序中文本范围的开始和结束端点之间的文本。

要求

   
最低受支持的客户端 Windows XP [桌面应用 | UWP 应用]
最低受支持的服务器 Windows Server 2003 [桌面应用 | UWP 应用]
目标平台 Windows
标头 uiautomationcore.h (包括 UIAutomation.h)

请参阅

概念性

ITextProvider

ITextRangeProvider

引用

UI 自动化提供程序概述