TreeWalker.Normalize メソッド

定義

AutomationElementのこのインスタンスで使用されるツリー ビューで、指定したTreeWalkerに最も近い先祖要素を取得します。

オーバーロード

名前 説明
Normalize(AutomationElement)

ノード自体が Conditionを満たす場合、または Conditionを満たす最も近い親ノードまたは先祖ノードを取得します。

Normalize(AutomationElement, CacheRequest)

Conditionを満たす場合はノード自体を取得し、Conditionを満たす最も近い親ノードまたは先祖ノードを取得し、プロパティとパターンをキャッシュします。

注釈

要素は、 TreeWalker オブジェクトのビュー条件を満たす要素に達するまで、ツリー内の先祖チェーンを上に移動することによって正規化されます。 ルート要素に達すると、ビュー条件を満たさない場合でもルート要素が返されます。

このメソッドは、ヒット テストによってUI オートメーション要素への参照を取得するアプリケーションに役立ちます。 アプリケーションでは、特定の種類の要素のみを操作する必要があり、 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 オブジェクトのビュー条件を満たす要素に達するまで、ツリー内の先祖チェーンを上に移動することによって正規化されます。 ルート要素に達すると、ビュー条件を満たさない場合でもルート要素が返されます。

このメソッドは、ヒット テストによってUI オートメーション要素への参照を取得するアプリケーションに役立ちます。 アプリケーションでは、特定の種類の要素のみを操作する必要があり、 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 オブジェクトのビュー条件を満たす要素に達するまで、ツリー内の先祖チェーンを上に移動することによって正規化されます。 ルート要素に達すると、ビュー条件を満たさない場合でもルート要素が返されます。

このメソッドは、ヒット テストによってUI オートメーション要素への参照を取得するアプリケーションに役立ちます。 アプリケーションでは、特定の種類の要素のみを操作する必要があり、 Normalize を使用して、最初に取得された要素 (スクロール バーが入力フォーカスを取得する場合など) に関係なく、対象の要素 (コンテンツ要素など) のみが最終的に取得されるようにすることができます。

こちらもご覧ください

適用対象