TreeWalker 類別

定義

命名空間:

System.Windows.Automation

組件:

UIAutomationClient.dll

提供用來巡覽使用者介面自動化樹狀目錄的方法和屬性。

public ref class TreeWalker sealed

public sealed class TreeWalker

type TreeWalker = class

Public NotInheritable Class TreeWalker

繼承

Object

TreeWalker

備註

消費者介面自動化用戶端會將桌面上的消費者介面自動化專案視為樹狀結構中排列的一組 AutomationElement 物件。

TreeWalker使用 類別，用戶端應用程式可以選取樹狀結構的檢視，並使用 、 GetLastChildGetPreviousSiblingGetNextSibling 、 和 GetParent 方法，以指定的方向 GetFirstChild 逐步執行樹 AutomationElement 狀結構，以巡覽消費者介面自動化樹狀結構。

使用 巡覽消費者介面自動化樹狀結構 TreeWalker 可能會導致跨進程呼叫，而且與使用 FindAll 或 FindFirst 方法尋找元素不一樣有效率。

如果您的用戶端應用程式可能會嘗試在自己的使用者介面中尋找元素，您必須在個別執行緒上發出所有消費者介面自動化呼叫。

建構函式

TreeWalker(Condition)

初始化 TreeWalker 類別的新執行個體。

欄位

ContentViewWalker	表示預先定義的 TreeWalker，內含在樹狀目錄中標記為內容控制項之項目的檢視。
ControlViewWalker	表示預先定義的 TreeWalker，內含在樹狀目錄中標記為控制項之項目的檢視。
RawViewWalker	表示預先定義的 TreeWalker，其中包含樹狀目錄中所有項目的檢視。

屬性

Condition

取得的物件定義 TreeWalker 物件的檢視。

方法

Equals(Object)	判斷指定的物件是否等於目前的物件。 (繼承來源 Object)
GetFirstChild(AutomationElement)	擷取所指定 AutomationElement 的第一個子項目。
GetFirstChild(AutomationElement, CacheRequest)	擷取指定之 AutomationElement 的第一個子項目並快取屬性和模式。
GetHashCode()	做為預設雜湊函式。 (繼承來源 Object)
GetLastChild(AutomationElement)	擷取所指定 AutomationElement 的最後一個子項目。
GetLastChild(AutomationElement, CacheRequest)	擷取指定之 AutomationElement 的最後一個子項目並快取屬性和模式。
GetNextSibling(AutomationElement)	擷取所指定 AutomationElement 的下一個同層級項目。
GetNextSibling(AutomationElement, CacheRequest)	擷取指定之 AutomationElement 的下一個同層級項目並快取屬性和模式。
GetParent(AutomationElement)	擷取所指定 AutomationElement 的父項目。
GetParent(AutomationElement, CacheRequest)	擷取指定之 AutomationElement 的父項目並快取屬性和模式。
GetPreviousSibling(AutomationElement)	擷取所指定 AutomationElement 的上一個同層級項目。
GetPreviousSibling(AutomationElement, CacheRequest)	擷取指定之 AutomationElement 的上一個同層級並快取屬性和模式。
GetType()	取得目前執行個體的 Type。 (繼承來源 Object)
MemberwiseClone()	建立目前 Object 的淺層複製。 (繼承來源 Object)
Normalize(AutomationElement)	如果節點符合 Condition，則擷取節點本身，或是擷取符合 Condition 的最近父代或祖系節點。
Normalize(AutomationElement, CacheRequest)	如果節點符合 Condition，則擷取節點本身，或是擷取符合 Condition 的最近父代或祖系節點，並快取屬性和模式。
ToString()	傳回代表目前物件的字串。 (繼承來源 Object)

另請參閱

• UI 自動化樹狀目錄概觀
• 使用 TreeWalker 巡覽 UI 自動化項目
• 取得 UI 自動化項目