AccessibleObjectFromWindow 関数 (oleacc.h)

  • [アーティクル]

指定したウィンドウに関連付けられているオブジェクトの指定したインターフェイスのアドレスを取得します。

構文

HRESULT AccessibleObjectFromWindow(
  [in]  HWND   hwnd,
  [in]  DWORD  dwId,
  [in]  REFIID riid,
  [out] void   **ppvObject
);

パラメーター

[in] hwnd

種類: HWND

オブジェクトを取得するウィンドウのハンドルを指定します。 カーソルまたはキャレット オブジェクトへのインターフェイス ポインターを取得するには、 NULL を 指定し、 dwObjectID で適切なオブジェクト ID を使用します。

[in] dwId

型: DWORD

オブジェクト ID を指定します。 この値は、標準の オブジェクト識別子 定数の 1 つ、または office ネイティブ オブジェクト モデルのオブジェクト ID である OBJID_NATIVEOM などのカスタム オブジェクト ID です。 OBJID_NATIVEOMの詳細については、このトピックの「解説」セクションを参照してください。

[in] riid

型: REFIID

要求されたインターフェイスの参照識別子を指定します。 この値はIID_IAccessibleまたはIID_IDispatchのいずれかですが、IID_IUnknownすることも、オブジェクトがサポートする必要があるインターフェイスの IID でもかまいません。

[out] ppvObject

型: void**

指定したインターフェイスのアドレスを受け取るポインター変数のアドレス。

戻り値

型: STDAPI

成功した場合は、S_OK を返します。

成功しなかった場合は、次のいずれかの標準 COM エラー コードを返します。

リターン コード 説明
E_INVALIDARG
 引数が有効ではありません。
E_NOINTERFACE
 要求されたインターフェイスはサポートされていません。

解説

クライアントはこの関数を呼び出して、オブジェクトの IAccessible、 IDispatch、 IEnumVARIANT、 IUnknown、またはその他のサポートされているインターフェイス ポインターのアドレスを取得します。

他 の IAccessible メソッドや関数と同様に、クライアントはユーザー アクションのために IAccessible インターフェイス ポインターのエラーを受け取る可能性があります。 詳細については、「 IAccessible インターフェイス ポインターのエラーの受信」を参照してください。

クライアントはこの関数を使用して、Microsoft Office 2000 ネイティブ オブジェクト モデルへのアクセスを取得します。 ネイティブ オブジェクト モデルは、Microsoft Active Accessibility によって公開されていない Office アプリケーションのドキュメントまたはクライアント領域に関するアクセシビリティ情報をクライアントに提供します。

ネイティブ オブジェクト モデルでサポートされているクラスへの IDispatch インターフェイス ポインターを取得するには、dwObjectID で OBJID_NATIVEOMを指定します。 このオブジェクト識別子を使用する場合、 hwnd パラメーターは次のウィンドウ クラス型と一致する必要があります。

Office アプリケーション Window クラス への IDispatch ポインター
Word _WwG ウィンドウ
Excel EXCEL7 ウィンドウ
PowerPoint paneClassDC DocumentWindow
コマンド バー MsoCommandBar CommandBar
 

上記のウィンドウ クラスは、最も内側のドキュメント ウィンドウまたはウィンドウ ウィンドウに対応しています。 Office オブジェクト モデルの詳細については、「 Microsoft Office 2000/Visual Basic プログラマー ガイド」を参照してください。

要件

要件 値
サポートされている最小のクライアント Windows 2000 Professional [デスクトップ アプリのみ]
サポートされている最小のサーバー Windows Server 2003 (デスクトップ アプリのみ)
対象プラットフォーム Windows
ヘッダー oleacc.h
Library Oleacc.lib
[DLL] Oleacc.dll
再頒布可能パッケージ SP6 以降および Windows 95 を使用した Windows NT 4.0 のアクティブなアクセシビリティ 1.3 RDK

こちらもご覧ください

AccessibleObjectFromEvent

AccessibleObjectFromPoint

Iaccessible

IDispatch