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

指定した条件に一致する最初の子要素または子孫要素を取得します。

構文

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

パラメーター

scope

[in] condition

種類: IUIAutomationCondition*

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

[out, retval] found

種類: IUIAutomationElement**

要素へのポインターを受け取ります。 一致する要素が見つからない場合、NULL が返されます。

戻り値

型: HRESULT

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

注釈

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

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

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

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

この関数は、生ツリー内の要素を無視します。 FindFirstBuildCache を呼び出して、その関数に渡された IUIAutomationCacheRequest で適切な TreeScope を指定して生のツリーを検索します。

要件

要件	値
サポートされている最小のクライアント	Windows 7、Windows Vista SP2 と Windows Vista 用プラットフォーム更新プログラム、WINDOWS XP SP3 と 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 を含む)

関連項目

概念

Findall

FindAllBuildCache

FindFirstBuildCache

IUIAutomationElement

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

参照