IUIAutomationTreeWalker 接口 (uiautomationclient.h)

公开UI 自动化客户端应用程序用于在桌面上查看和导航UI 自动化元素的属性和方法。

继承

IUIAutomationTreeWalker 接口继承自 IUnknown 接口。 IUIAutomationTreeWalker 也具有以下类型的成员：

方法

IUIAutomationTreeWalker 接口包含以下方法。

IUIAutomationTreeWalker：：get_Condition 检索定义UI 自动化树视图的条件。
IUIAutomationTreeWalker：：GetFirstChildElement 检索指定UI 自动化元素的第一个子元素。
IUIAutomationTreeWalker：：GetFirstChildElementBuildCache 检索指定UI 自动化元素的第一个子元素，并缓存属性和控件模式。
IUIAutomationTreeWalker：：GetLastChildElement 检索指定UI 自动化元素的最后一个子元素。
IUIAutomationTreeWalker：：GetLastChildElementBuildCache 检索指定UI 自动化元素的最后一个子元素，并缓存属性和控件模式。
IUIAutomationTreeWalker：：GetNextSiblingElement 检索指定UI 自动化元素的下一个同级元素。
IUIAutomationTreeWalker：：GetNextSiblingElementBuildCache 检索指定UI 自动化元素的下一个同级元素，并缓存属性和控件模式。
IUIAutomationTreeWalker：：GetParentElement 检索指定UI 自动化元素的父元素。
IUIAutomationTreeWalker：：GetParentElementBuildCache 检索指定UI 自动化元素的父元素，并缓存属性和控件模式。
IUIAutomationTreeWalker：：GetPreviousSiblingElement 检索指定UI 自动化元素的上一个同级元素。
IUIAutomationTreeWalker：：GetPreviousSiblingElementBuildCache 检索指定UI 自动化元素的上一个同级元素，并缓存属性和控件模式。
IUIAutomationTreeWalker：：NormalizeElement 检索树视图中最靠近指定 Microsoft UI 自动化 元素的上级元素。
IUIAutomationTreeWalker：：NormalizeElementBuildCache 检索树视图中离指定 Microsoft UI 自动化 元素最近的上级元素，预提取请求的属性和控件模式，并将预提取的项存储在缓存中。

注解

UI 自动化客户端将桌面上的元素视为在树结构中排列的一组 IUIAutomation 对象。 使用 IUIAutomationTreeWalker 接口，客户端应用程序可以通过选择树视图并使用 GetFirstChildElement 和 GetNextSiblingElement 等方法在指定方向上从一个元素单步执行到另一个元素进行导航。

使用 IUIAutomationTreeWalker 导航树可能会导致跨进程调用，并且不如使用 IUIAutomationElement：：FindAll 或 IUIAutomationElement：：FindFirst 方法查找元素的效率。

如果客户端应用程序可能尝试在其自己的用户界面中查找元素，则必须在单独的线程上进行所有UI 自动化调用。

要求

要求	值
最低受支持的客户端	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)

另请参阅

CreateTreeWalker

客户端UI 自动化元素接口