TreeWalker.Normalize 方法
定義
重要
部分資訊涉及發行前產品,在發行之前可能會有大幅修改。 Microsoft 對此處提供的資訊,不做任何明確或隱含的瑕疵擔保。
擷取本實例AutomationElement所用樹狀視圖中最接近指定TreeWalker元素的祖先元素。
多載
備註
元素透過在樹中的祖先鏈上方導航,直到達到滿足該物件視圖條件 TreeWalker 的元素來正規化。 若達到根元素,即使不滿足視圖條件,仍回傳根元素。
此方法對於透過點擊測試取得 使用者介面自動化 元素參考的應用程式非常有用。 應用程式可能只想處理特定類型的元素,並可確保 Normalize 無論最初擷取哪個元素(例如當滾動列取得輸入焦點時),最終只會擷取感興趣的元素(例如內容元素)。
Normalize(AutomationElement)
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)
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 無論最初擷取哪個元素(例如當滾動列取得輸入焦點時),最終只會擷取感興趣的元素(例如內容元素)。