共用方式為

TreeWalker.Normalize 方法

  • 參考

定義

命名空間:
System.Windows.Automation
組件:
UIAutomationClient.dll

在此 AutomationElement 執行個體使用的樹狀檢視中，擷取最接近指定之 TreeWalker 的祖系項目。

多載

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

目前檢視中最近的 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

目前檢視中最近的 AutomationElement。 如果向上巡覽祖系鏈結時到達根項目，則會傳回根項目。

備註

元素會透過巡覽樹狀結構中的上階鏈結正規化，直到到達符合物件檢視條件的專案 TreeWalker 為止。 如果到達根項目，即使根項目不符合檢視條件，也會傳回根項目。

這個方法適用于透過點擊測試取得消費者介面自動化元素參考的應用程式。 例如，當捲軸取得輸入焦點) 時，只有當捲軸取得輸入焦點時，最終只會擷 (取內容元素，例如內容元素 () 等內容元素，應用程式可能只想要處理特定類型的專案， Normalize 並可用來確保不論最初擷取的專案為何。

另請參閱

適用於