IUIAutomationTreeWalker::NormalizeElement メソッド (uiautomationclient.h)

ツリー ビューで指定された Microsoft UI オートメーション要素に最も近い先祖要素を取得します。

構文

HRESULT NormalizeElement(
  [in]          IUIAutomationElement *element,
  [out, retval] IUIAutomationElement **normalized
);

パラメーター

[in] element

種類: IUIAutomationElement*

正規化を開始する要素へのポインター。

[out, retval] normalized

種類: IUIAutomationElement**

ツリー ビューで指定した要素に最も近い先祖要素へのポインターを受け取ります。

戻り値

種類: HRESULT

このメソッドは、成功すると S_OK を返します。 そうでない場合は、HRESULT エラー コードを返します。

解説

要素は、ビュー条件を満たす要素 ( IUIAutomationTreeWalker::Condition の以前の呼び出しで指定) に達するまで、ツリー内の先祖チェーンを上に移動することによって正規化されます。 しかし、最初に、渡された要素が正規化条件と一致するかどうかを確認するためにテストされます。 その場合、渡された要素は先祖ではないにもかかわらず返されます。

一致する要素が見つからない場合、メソッドは UIA_E_ELEMENTNOTAVAILABLE を返します。

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

要件

サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、SP3 を使用した Windows XP、Windows Vista 用プラットフォーム更新プログラム [デスクトップ アプリのみ]
サポートされている最小のサーバー	Windows Server 2008 R2、Windows Server 2008 SP2 および Windows Server 2008 用プラットフォーム更新プログラム、WINDOWS Server 2003 SP2 および Windows Server 2008 用プラットフォーム更新プログラム [デスクトップ アプリのみ]
対象プラットフォーム	Windows
ヘッダー	uiautomationclient.h (UIAutomation.h を含む)