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

[アーティクル]
08/26/2023

指定した条件に一致する最初の子要素または子孫要素を取得し、要求されたプロパティとコントロールパターンをプリフェッチし、プリフェッチされた項目をキャッシュに格納します。

構文

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

パラメーター

scope

[in] condition

種類: IUIAutomationCondition*

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

[in] cacheRequest

種類: IUIAutomationCacheRequest*

キャッシュに含めるコントロールパターンとプロパティを指定するキャッシュ要求へのポインター。

[out, retval] found

種類: IUIAutomationElement**

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

戻り値

種類: HRESULT

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

注釈

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

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

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

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

生のツリーを検索するには、cacheRequest パラメーターに適切な TreeScope を指定します。

要件

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