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

現在のビュー内で最も近くにある 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

現在のビュー内で最も近くにある AutomationElement。 先祖チェーンを上方向に移動することによってルート要素に到達した場合は、ルート要素が返されます。

注釈

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

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

こちらもご覧ください

適用対象