TreeWalker.Normalize メソッド
定義
重要
一部の情報は、リリース前に大きく変更される可能性があるプレリリースされた製品に関するものです。 Microsoft は、ここに記載されている情報について、明示または黙示を問わず、一切保証しません。
AutomationElementのこのインスタンスで使用されるツリー ビューで、指定したTreeWalkerに最も近い先祖要素を取得します。
オーバーロード
| 名前 | 説明 |
|---|---|
| Normalize(AutomationElement) |
ノード自体が Conditionを満たす場合、または Conditionを満たす最も近い親ノードまたは先祖ノードを取得します。 |
| Normalize(AutomationElement, CacheRequest) |
Conditionを満たす場合はノード自体を取得し、Conditionを満たす最も近い親ノードまたは先祖ノードを取得し、プロパティとパターンをキャッシュします。 |
注釈
要素は、 TreeWalker オブジェクトのビュー条件を満たす要素に達するまで、ツリー内の先祖チェーンを上に移動することによって正規化されます。 ルート要素に達すると、ビュー条件を満たさない場合でもルート要素が返されます。
このメソッドは、ヒット テストによってUI オートメーション要素への参照を取得するアプリケーションに役立ちます。 アプリケーションでは、特定の種類の要素のみを操作する必要があり、 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 オブジェクトのビュー条件を満たす要素に達するまで、ツリー内の先祖チェーンを上に移動することによって正規化されます。 ルート要素に達すると、ビュー条件を満たさない場合でもルート要素が返されます。
このメソッドは、ヒット テストによってUI オートメーション要素への参照を取得するアプリケーションに役立ちます。 アプリケーションでは、特定の種類の要素のみを操作する必要があり、 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 オブジェクトのビュー条件を満たす要素に達するまで、ツリー内の先祖チェーンを上に移動することによって正規化されます。 ルート要素に達すると、ビュー条件を満たさない場合でもルート要素が返されます。
このメソッドは、ヒット テストによってUI オートメーション要素への参照を取得するアプリケーションに役立ちます。 アプリケーションでは、特定の種類の要素のみを操作する必要があり、 Normalize を使用して、最初に取得された要素 (スクロール バーが入力フォーカスを取得する場合など) に関係なく、対象の要素 (コンテンツ要素など) のみが最終的に取得されるようにすることができます。