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.AutomationElementPublic 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.AutomationElementPublic Function Normalize (element As AutomationElement, request As CacheRequest) As AutomationElementパラメーター
- element
- AutomationElement
正規化の開始点となった要素。
- request
- CacheRequest
キャッシュ対象として返される AutomationElement のプロパティおよびパターンを指定するキャッシュ要求オブジェクト。
戻り値
現在のビュー内で最も近くにある AutomationElement。 先祖チェーンを上方向に移動することによってルート要素に到達した場合は、ルート要素が返されます。
注釈
要素は、オブジェクトのビュー条件を満たす要素に達するまで、ツリー内の先祖チェーンを TreeWalker 上に移動することによって正規化されます。 ルート要素に到達した場合、ビュー条件を満たさない場合でもルート要素が返されます。
このメソッドは、ヒット テストによってUI オートメーション要素への参照を取得するアプリケーションに役立ちます。 アプリケーションでは、特定の種類の要素のみを操作 Normalize する必要があり、最初に取得される要素 (スクロール バーが入力フォーカスを取得した場合など) に関係なく、最終的には対象の要素 (コンテンツ要素など) のみが取得されるようにすることができます。