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