Export (0) Print
Expand All

IUIAutomationTreeWalker Interface

Exposes properties and methods that UI Automation client applications use to view and navigate the UI Automation elements on the desktop.

IUIAutomationTreeWalker Members

Condition Retrieves the condition that defines the view of the Microsoft UI Automation tree.
GetFirstChild Retrieves the first child element of the specified UI Automation element.
GetFirstChildBuildCache Retrieves the first child element of the specified UI Automation element, and caches properties and control patterns.
GetLastChild Retrieves the last child element of the specified UI Automation element.
GetLastChildBuildCache Retrieves the last child element of the specified UI Automation element, and caches properties and control patterns.
GetNextSibling Retrieves the next sibling element of the specified UI Automation element, and caches properties and control patterns.
GetNextSiblingBuildCache Retrieves the next sibling element of the specified UI Automation element, and caches properties and control patterns.
GetParentElement Retrieves the parent element of the specified UI Automation element.
GetParentElementBuildCache Retrieves the parent element of the specified UI Automation element, and caches properties and control patterns.
GetPreviousSibling Retrieves the previous sibling element of the specified UI Automation element, and caches properties and control patterns.
GetPreviousSiblingBuildCache Retrieves the previous sibling element of the specified UI Automation element, and caches properties and control patterns.
Normalize Retrieves the ancestor element nearest to the specified UI Automation element in the tree view.
NormalizeBuildCache Retrieves the ancestor element nearest to the specified UI Automation element in the tree view, prefetches the requested properties and control patterns, and stores the prefetched items in the cache.

Remarks

UI Automation clients view the elements on the desktop as a set of IUIAutomation objects arranged in a tree structure. Using the IUIAutomationTreeWalker interface, a client application can navigate by selecting a view of the tree and stepping from one element to another in a specified direction using methods such as IUIAutomationTreeWalker::GetFirstChild and IUIAutomationTreeWalker::GetNextSibling.

Navigating the tree using IUIAutomationTreeWalker can result in cross-process calls and is not as efficient as locating an element using the IUIAutomationElement::FindAll or IUIAutomationElement::FindFirst methods.

If your client application might try to find elements in its own user interface, you must make all UI Automation calls on a separate thread.

Interface Information

Inherits from IUnknown
Header and IDL files uiautomation.h, uiautomationclient.idl
Minimum operating systems Windows 7

See Also

IUIAutomation::CreateTreeWalker

Community Additions

Show:
© 2014 Microsoft