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

Microsoft Active Accessibility サーバーから、指定したアクセス可能なオブジェクトのUI オートメーション要素を取得します。

構文

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

パラメーター

[in] accessible

種類: IAccessible*

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

[in] childId

型: int

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

[out, retval] element

種類: IUIAutomationElement**

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

戻り値

型: HRESULT

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

注釈

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

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

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

要件

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