ITextRangeProvider：：FindAttribute 方法 (uiautomationcore.h)

  • 项目

返回具有指定文本属性值的文本范围子集。

语法

HRESULT FindAttribute(
  [in]          TEXTATTRIBUTEID    attributeId,
  [in]          VARIANT            val,
  [in]          BOOL               backward,
  [out, retval] ITextRangeProvider **pRetVal
);

参数

[in] attributeId

类型： TEXTATTRIBUTEID

文本属性的标识符。 有关文本属性 ID 的列表，请参阅 文本属性标识符。

[in] val

类型： VARIANT

要搜索的特性值。 此值必须与为特性指定的类型匹配。

[in] backward

类型： BOOL

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

[out, retval] pRetVal

类型： ITextRangeProvider**

接收指向具有匹配特性和属性值的文本范围的指针;否则 为 NULL。

返回值

类型： HRESULT

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

注解

无论文本是隐藏还是可见， FindAttribute 方法都会检索匹配的文本。 客户端可以使用UIA_IsHiddenAttributeId来检查文本可见性。

要求

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

请参阅

概念性

ITextProvider

ITextRangeProvider

引用

UI 自动化提供程序概述