IUIAutomationElement7::FindAllWithOptionsBuildCache 方法 (uiautomationclient.h)

按指定顺序查找所有匹配的元素,但也缓存其属性和模式。

语法

HRESULT FindAllWithOptionsBuildCache(
  [in]          TreeScope                 scope,
  [in]          IUIAutomationCondition    *condition,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [in]          TreeTraversalOptions      traversalOptions,
  [in]          IUIAutomationElement      *root,
  [out, retval] IUIAutomationElementArray **found
);

参数

[in] scope

类型: TreeScope

请求的范围。

检索元素时,只能对元素本身 (默认行为) 或元素及其子级或后代执行缓存。 此属性描述请求的范围。

[in] condition

类型: IUIAutomationCondition

搜索UI 自动化树中的元素时用于筛选条件的主接口。

[in] cacheRequest

类型: IUIAutomationCacheRequest

指向缓存请求的指针,指定要包含在缓存中的控件模式和属性。

[in] traversalOptions

类型: TreeTraversalOptions

树导航顺序。

[in] root

类型: IUIAutomationElement

指向用于开始搜索的元素的指针。

[out, retval] found

接收指向匹配元素数组的指针。 如果未找到匹配的元素,则返回空数组。

返回值

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

要求

要求
最低受支持的客户端 Windows 10版本 1703 [仅限桌面应用]
最低受支持的服务器 Windows Server 2016 [仅限桌面应用]
目标平台 Windows
标头 uiautomationclient.h (包括 UIAutomation.h)
DLL UIAutomationCore.dll

另请参阅

IUIAutomationElement7