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 エラー コードを返します。
リターン コード | 説明 |
---|---|
|
引数が有効ではありません。 |
|
要求されたインターフェイスはサポートされていません。 |
解説
クライアントはこの関数を呼び出して、オブジェクトの 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 |