CreateStdAccessibleObject-Funktion (oleacc.h)

  • Artikel

Erstellt ein barrierefreies Objekt mit den Methoden und Eigenschaften des angegebenen Typs des vom System bereitgestellten Benutzeroberflächenelements.

Syntax

HRESULT CreateStdAccessibleObject(
  [in]  HWND   hwnd,
  [in]  LONG   idObject,
  [in]  REFIID riid,
  [out] void   **ppvObject
);

Parameter

[in] hwnd

Typ: HWND

Fensterhandle des vom System bereitgestellten Benutzeroberflächenelements (ein Steuerelement), für das ein barrierefreies Objekt erstellt wird.

[in] idObject

Typ: LONG

Objekt-ID. Dieser Wert ist in der Regel OBJID_CLIENT, aber es kann sich um einen anderen Objektbezeichner handeln.

[in] riid

Typ: REFIID

Referenzbezeichner der angeforderten Schnittstelle. Dieser Wert ist einer der folgenden: IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT oder IID_IUnknown.

[out] ppvObject

Typ: void**

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

Rückgabewert

Typ: STDAPI

Gibt bei Erfolg S_OK zurück.

Wenn dies nicht erfolgreich ist, wird ein COM-Standardfehlercode zurückgegeben.

Hinweise

Serveranwendungen rufen diese Funktion auf, wenn sie ein benutzerdefiniertes UI-Objekt enthalten, das einem vom System bereitgestellten Objekt ähnelt. Serverentwickler können CreateStdAccessibleObject aufrufen, um die IAccessible-Methoden und -Eigenschaften nach Bedarf zu überschreiben, um ihre benutzerdefinierten Objekte abzugleichen. Alternativ können Serverentwickler die dynamische Anmerkung verwenden, um bestimmte Eigenschaften außer Kraft zu setzen, ohne schwierige Unterklassentechniken verwenden zu müssen, die CreateStdAccessibleObject erfordert. Serverentwickler sollten weiterhin CreateStdAccessibleObject für strukturelle Änderungen verwenden, z. B. für das Ausblenden eines untergeordneten Elements oder das Erstellen eines untergeordneten Platzhalterelements. Dieser Ansatz erspart Serverentwicklern die vollständige Implementierung aller IAccessible-Eigenschaften und -Methoden.

Diese Funktion ähnelt CreateStdAccessibleProxy, mit der Ausnahme, dass Sie mit CreateStdAccessibleProxy den Klassennamen als Parameter angeben können, während CreateStdAccessibleObject den Klassennamen verwendet, der dem hwnd-Parameter zugeordnet ist.

Anforderungen

   
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

CreateStdAccessibleProxy

IDispatch

Tastenkombinationen zum Verfügbarmachen benutzerdefinierter Benutzeroberflächenelemente