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

Microsoft Active Accessibility サーバーから、指定されたアクセス可能なオブジェクトの UI オートメーション要素を取得し、要求されたプロパティとコントロール パターンをプリフェッチし、プリフェッチされた項目をキャッシュに格納します。

構文

HRESULT ElementFromIAccessibleBuildCache(
  [in]          IAccessible               *accessible,
  [in]          int                       childId,
  [in]          IUIAutomationCacheRequest *cacheRequest,
  [out, retval] IUIAutomationElement      **element
);

パラメーター

[in] accessible

種類: IAccessible*

アクセス 可能なオブジェクトの IAccessible インターフェイスへのポインター。

[in] childId

型: int

アクセス可能なオブジェクトの子 ID。

[in] cacheRequest

種類: IUIAutomationCacheRequest**

キャッシュに格納するプロパティとコントロール パターンを指定するキャッシュ要求のアドレス。

[out, retval] element

種類: IUIAutomationElement**

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

戻り値

型: HRESULT

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

解説

このメソッドを使用すると、Microsoft UI オートメーション クライアントは、Microsoft Active Accessibility サーバーによって実装されたアクセス可能なオブジェクトの IUIAutomationElement インターフェイスを取得できます。

サーバーが Microsoft Active Accessibility サポートと共に UI オートメーション プロバイダー インターフェイスを実装している場合、このメソッドは失敗する可能性があります。

UI オートメーション要素の基になる実装がネイティブの Microsoft Active Accessibility サーバーでない場合、メソッドはE_INVALIDARGを返します。つまり、クライアントがプロキシ オブジェクトによって最初にサポートされていた要素の IAccessible インターフェイスを Oleacc.dll から取得しようとした場合、または UIA から MSAA ブリッジで取得しようとした場合です。

要件

サポートされている最小のクライアント	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::ElementFromHandleBuildCache