IUIAutomation::GetRootElementBuildCache メソッド (uiautomationclient.h)

デスクトップを表すUI オートメーション要素を取得し、要求されたプロパティとコントロールパターンをプリフェッチし、プリフェッチされた項目をキャッシュに格納します。

構文

HRESULT GetRootElementBuildCache(
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **root
);

[in] cacheRequest

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

[out, retval] root

UI オートメーション要素へのポインターを受け取ります。

型: HRESULT

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

ルート要素は、 FindAll メソッドと FindFirst メソッドを使用して、他の要素を検索するための開始点として使用できます。

ルート要素から検索する場合は、TreeScope_Descendantsではなく、検索のスコープで TreeScope_Childrenを指定してください。デスクトップのサブツリー全体を検索すると、何千もの項目が反復処理され、スタックオーバーフローが発生する可能性があります。

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