IUIAutomationElement::FindAll メソッド (uiautomationclient.h)

  • [アーティクル]

指定した条件を満たすUI オートメーション要素をすべて返します。

構文

HRESULT FindAll(
                TreeScope                 scope,
  [in]          IUIAutomationCondition    *condition,
  [out, retval] IUIAutomationElementArray **found
);

パラメーター

scope

[in] condition

種類: IUIAutomationCondition*

一致する条件を表す条件へのポインター。

[out, retval] found

種類: IUIAutomationElementArray**

一致する要素の配列へのポインターを受け取ります。 一致する要素が見つからない場合は、空の配列を返します。

戻り値

種類: HRESULT

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

注釈

検索のスコープは、 メソッドが呼び出される要素に対して相対的です。 要素は、ツリーで検出された順序で返されます。

この関数は、Microsoft UI オートメーション ツリー内の先祖要素を検索できません。つまり、TreeScope_Ancestors はスコープ パラメーターの有効な値ではありません。

デスクトップで最上位のウィンドウを検索する場合は、 TreeScope_Descendants ではなく 、スコープ パラメーターに TreeScope_Childrenを指定してください。 デスクトップのサブツリー全体を検索すると、何千もの項目が反復処理され、スタック オーバーフローが発生する可能性があります。

クライアント アプリケーションが独自のユーザー インターフェイスで要素を検索しようとする場合は、すべてのUI オートメーション呼び出しを別のスレッドで行う必要があります。

要件

要件 値
サポートされている最小のクライアント 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 を含む)

関連項目

概念

FindAllBuildCache

Findfirst

FindFirstBuildCache

IUIAutomationElement

UI オートメーション要素の取得

参照