語言

TreeWalker.Normalize 方法

定義

擷取本實例AutomationElement所用樹狀視圖中最接近指定TreeWalker元素的祖先元素。

多載

名稱 Description
Normalize(AutomationElement)

若節點本身滿足 Condition,或最近的父節點或祖 Condition先節點滿足 ,則擷取該節點本身。

Normalize(AutomationElement, CacheRequest)

若節點本身滿足 Condition,或最近的父節點或祖 Condition節點滿足 ,則擷取該節點,並快取屬性與模式。

備註

元素透過在樹中的祖先鏈上方導航,直到達到滿足該物件視圖條件 TreeWalker 的元素來正規化。 若達到根元素,即使不滿足視圖條件,仍回傳根元素。

此方法對於透過點擊測試取得 使用者介面自動化 元素參考的應用程式非常有用。 應用程式可能只想處理特定類型的元素,並可確保 Normalize 無論最初擷取哪個元素(例如當滾動列取得輸入焦點時),最終只會擷取感興趣的元素(例如內容元素)。

Normalize(AutomationElement)

若節點本身滿足 Condition,或最近的父節點或祖 Condition先節點滿足 ,則擷取該節點本身。

public:
 System::Windows::Automation::AutomationElement ^ Normalize(System::Windows::Automation::AutomationElement ^ element);
public System.Windows.Automation.AutomationElement Normalize(System.Windows.Automation.AutomationElement element);
member this.Normalize : System.Windows.Automation.AutomationElement -> System.Windows.Automation.AutomationElement
Public Function Normalize (element As AutomationElement) As AutomationElement

參數

element
AutomationElement

這是開始正規化的元素。

傳回

目前視野中最近的 AutomationElement 。 如果沿祖先鏈的導覽到達根元素,則會回傳根元素。

備註

元素透過在樹中的祖先鏈上方導航,直到達到滿足該物件視圖條件 TreeWalker 的元素來正規化。 若達到根元素,即使不滿足視圖條件,仍回傳根元素。

此方法對於透過點擊測試取得 使用者介面自動化 元素參考的應用程式非常有用。 應用程式可能只想處理特定類型的元素,並可確保 Normalize 無論最初擷取哪個元素(例如當滾動列取得輸入焦點時),最終只會擷取感興趣的元素(例如內容元素)。

另請參閱

適用於

Normalize(AutomationElement, CacheRequest)

若節點本身滿足 Condition,或最近的父節點或祖 Condition節點滿足 ,則擷取該節點,並快取屬性與模式。

public:
 System::Windows::Automation::AutomationElement ^ Normalize(System::Windows::Automation::AutomationElement ^ element, System::Windows::Automation::CacheRequest ^ request);
public System.Windows.Automation.AutomationElement Normalize(System.Windows.Automation.AutomationElement element, System.Windows.Automation.CacheRequest request);
member this.Normalize : System.Windows.Automation.AutomationElement * System.Windows.Automation.CacheRequest -> System.Windows.Automation.AutomationElement
Public Function Normalize (element As AutomationElement, request As CacheRequest) As AutomationElement

參數

element
AutomationElement

這是開始正規化的元素。

request
CacheRequest

一個快取請求物件,指定返回 AutomationElement 快取的屬性與模式。

傳回

目前視野中最近的 AutomationElement 。 如果沿祖先鏈的導覽到達根元素,則會回傳根元素。

備註

元素透過在樹中的祖先鏈上方導航,直到達到滿足該物件視圖條件 TreeWalker 的元素來正規化。 若達到根元素,即使不滿足視圖條件,仍回傳根元素。

此方法對於透過點擊測試取得 使用者介面自動化 元素參考的應用程式非常有用。 應用程式可能只想處理特定類型的元素,並可確保 Normalize 無論最初擷取哪個元素(例如當滾動列取得輸入焦點時),最終只會擷取感興趣的元素(例如內容元素)。

另請參閱

適用於