IUIAutomationTextRange::FindText 方法 (uiautomationclient.h)

检索包含指定文本的文本范围子集。

语法

HRESULT FindText(
  [in]          BSTR                   text,
  [in]          BOOL                   backward,
  [in]          BOOL                   ignoreCase,
  [out, retval] IUIAutomationTextRange **found
);

参数

[in] text

类型: BSTR

要查找的文本。

[in] backward

类型: BOOL

如果应返回最后一个文本范围而不是第一个文本范围,则为 TRUE;否则为 FALSE

[in] ignoreCase

类型: BOOL

如果应忽略大小写,则为 TRUE;否则为 FALSE

[out, retval] found

类型: IUIAutomationTextRange**

接收指向文本范围的指针;如果未找到匹配项,则为 NULL

返回值

类型: HRESULT

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

注解

隐藏文本和可见文本之间没有区别。

要求

要求
最低受支持的客户端 Windows 7、带 SP2 的 Windows Vista 和适用于 Windows Vista 的平台更新、带 SP3 的 Windows XP 和适用于 Windows Vista 的平台更新 [仅限桌面应用]
最低受支持的服务器 Windows Server 2008 R2、Windows Server 2008 SP2 和 Platform Update for Windows Server 2008、Windows Server 2003 SP2 和 Platform Update for Windows Server 2008 [仅限桌面应用]
目标平台 Windows
标头 uiautomationclient.h (包括 UIAutomation.h)

另请参阅

IUIAutomationTextRange

对文本内容的UI 自动化支持