AccessibleObjectFromWindow-Funktion (oleacc.h)

Ruft die Adresse der angegebenen Schnittstelle für das Objekt ab, das dem angegebenen Fenster zugeordnet ist.

Syntax

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

Parameter

[in] hwnd

Typ: HWND

Gibt das Handle eines Fensters an, für das ein Objekt abgerufen werden soll. Um einen Schnittstellenzeiger auf das Cursor- oder Caret-Objekt abzurufen, geben Sie NULL an, und verwenden Sie die entsprechende Objekt-ID in dwObjectID.

[in] dwId

Typ: DWORD

Gibt die Objekt-ID an. Dieser Wert ist eine der Standardobjektbezeichnerkonstanten oder eine benutzerdefinierte Objekt-ID wie OBJID_NATIVEOM, die objekt-ID für das systemeigene Office-Objektmodell. Weitere Informationen zu OBJID_NATIVEOM finden Sie im Abschnitt Hinweise in diesem Thema.

[in] riid

Typ: REFIID

Gibt den Verweisbezeichner der angeforderten Schnittstelle an. Dieser Wert ist entweder IID_IAccessible oder IID_IDispatch, kann aber auch IID_IUnknown oder die IID einer beliebigen Schnittstelle sein, die vom Objekt unterstützt werden soll.

[out] ppvObject

Typ: void**

Adresse einer Zeigervariable, die die Adresse der angegebenen Schnittstelle empfängt.

Rückgabewert

Typ: STDAPI

Gibt bei Erfolg S_OK zurück.

Wenn dies nicht erfolgreich ist, gibt einen der folgenden oder einen anderen COM-Standardfehlercode zurück.

Bemerkungen

Clients rufen diese Funktion auf, um die Adresse des IAccessible-, IDispatch-, IEnumVARIANT-, IUnknown- oder anderen unterstützten Schnittstellenzeigers eines Objekts abzurufen.

Wie bei anderen IAccessible-Methoden und Funktionen erhalten Clients aufgrund einer Benutzeraktion möglicherweise Fehler für IAccessible-Schnittstellenzeiger . Weitere Informationen finden Sie unter Empfangen von Fehlern für IAccessible-Schnittstellenzeiger.

Clients verwenden diese Funktion, um Zugriff auf das native Microsoft Office 2000-Objektmodell zu erhalten. Das systemeigene Objektmodell stellt Clients Barrierefreiheitsinformationen zum Dokument oder Clientbereich einer Office-Anwendung bereit, die nicht von Microsoft Active Accessibility verfügbar gemacht werden.

Um einen IDispatch-Schnittstellenzeiger auf eine Klasse abzurufen, die vom systemeigenen Objektmodell unterstützt wird, geben Sie OBJID_NATIVEOM in dwObjectID an. Bei Verwendung dieses Objektbezeichners muss der hwnd-Parameter mit den folgenden Fensterklassentypen übereinstimmen.

Beachten Sie, dass die obigen Fensterklassen dem innersten Dokument- oder Bereichsfenster entsprechen. Weitere Informationen zum Office-Objektmodell finden Sie im Microsoft Office 2000/Visual Basic-Programmierhandbuch.

Anforderungen

Weitere Informationen

AccessibleObjectFromEvent

AccessibleObjectFromPoint

Iaccessible

IDispatch