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.
| Rückgabecode | Beschreibung |
|---|---|
|
Ein Argument ist ungültig. |
|
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 |