CreateStdAccessibleProxyW-Funktion (oleacc.h)

Artikel
08/25/2023

Erstellt ein barrierefreies Objekt, das über die Eigenschaften und Methoden der angegebenen Klasse des vom System bereitgestellten Benutzeroberflächenelements verfügt.

Syntax

HRESULT CreateStdAccessibleProxyW(
  [in]  HWND    hwnd,
  [in]  LPCWSTR pClassName,
  [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] pClassName

Typ: LPCTSTR

Zeiger auf eine NULL-endende Zeichenfolge des Klassennamens eines vom System bereitgestellten Benutzeroberflächenelements, für das ein barrierefreies Objekt erstellt wird. Der Name der Fensterklasse ist eines der allgemeinen Steuerelemente (definiert in Comctl32.dll), vordefinierten Steuerelementen (definiert in User32.dll) oder Fensterelementen.

[in] idObject

Typ: LONG

Objekt-ID. Dieser Wert ist in der Regel OBJID_CLIENT, die eine der Objektbezeichnerkonstanten ist, 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 Steuerelement enthalten, das einem vom System bereitgestellten Steuerelement ähnelt. Serveranwendungen können CreateStdAccessibleProxy aufrufen, um die IAccessible-Methoden und -Eigenschaften nach Bedarf zu überschreiben, um ihren benutzerdefinierten Steuerelementen zu entsprechen. Alternativ können Serverentwickler die dynamische Anmerkung verwenden, um bestimmte Eigenschaften außer Kraft zu setzen, ohne schwierige Unterklassentechniken verwenden zu müssen, die für CreateStdAccessibleProxy erforderlich waren. Serverentwickler sollten weiterhin CreateStdAccessibleProxy 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 CreateStdAccessibleObject, mit der Ausnahme, dass CreateStdAccessibleObject immer den Klassennamen verwendet, der dem hwnd zugeordnet ist, während Sie mit CreateStdAccessibleProxy den Klassennamen als Parameter angeben können.

Verwenden Sie CreateStdAccessibleProxy , um ein barrierefreies Objekt für ein Benutzeroberflächenelement zu erstellen, das als übergeordnete Klasse eingestuft ist. Wenn ein Benutzeroberflächenelement überklassigt wird, erstellt eine Anwendung ein benutzerdefiniertes Steuerelement mit einem Fensterklassennamen, der sich vom vordefinierten Steuerelement unterscheidet, auf dem es basiert. Da der Klassenname, der dem hwnd-Parameter zugeordnet ist, der Name des Superklassenfensters ist, geben Sie den Namen der Basisklasse (den Systemklassennamen, auf dem das übergeordnete Steuerelement basiert) in pszClassName an.

Hinweis

Der oleacc.h-Header definiert CreateStdAccessibleProxy als Alias, der die ANSI- oder Unicode-Version dieser Funktion basierend auf der Definition der UNICODE-Präprozessorkonstante automatisch auswählt. Das Mischen der Verwendung des codierungsneutralen Alias mit Code, der nicht Codierungsneutral ist, kann zu Nichtübereinstimmungen führen, die zu Kompilierungs- oder Laufzeitfehlern führen. Weitere Informationen finden Sie unter Konventionen für Funktionsprototypen.

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

Anhang A: Referenz zu unterstützten Benutzeroberflächenelementen

CreateStdAccessibleObject

IDispatch

Tastenkombinationen zum Verfügbarmachen benutzerdefinierter Benutzeroberflächenelemente

Share via