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

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

構文

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

パラメーター

[in] cacheRequest

種類: IUIAutomationCacheRequest*

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

[out, retval] root

種類: IUIAutomationElement**

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 を含む)

こちらもご覧ください

IUIAutomation

IUIAutomation::GetRootElement