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) |
请参阅
概念性
引用