AccessibleObjectFromWindow-Funktion (oleacc.h)

Artikel
08/25/2023

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.

Rückgabecode	Beschreibung
E_INVALIDARG	Ein Argument ist ungültig.
E_NOINTERFACE	Die angeforderte Schnittstelle wird nicht unterstützt.

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.

Office-Anwendung	Window-Klasse	IDispatch-Zeiger auf
Word	_WwG	Fenster
Excel	EXCEL7	Fenster
PowerPoint	paneClassDC	DocumentWindow
Befehlsleisten	MsoCommandBar	CommandBar

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

Anforderung	Wert
Unterstützte Mindestversion (Client)	Windows 2000 Professional [nur Desktop-Apps]
Unterstützte Mindestversion (Server)	Windows Server 2003 [nur Desktop-Apps]
Zielplattform	Windows
Kopfzeile	oleacc.h
Bibliothek	Oleacc.lib
DLL	Oleacc.dll
Verteilbare Komponente	Active Accessibility 1.3 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 95

Weitere Informationen

AccessibleObjectFromEvent

AccessibleObjectFromPoint

Iaccessible

IDispatch

Share via