CreateStdAccessibleProxyA-Funktion (oleacc.h)

Artikel
11/20/2024

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

Syntax

HRESULT CreateStdAccessibleProxyA(
  [in]  HWND   hwnd,
  [in]  LPCSTR 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-

Zeigen Sie auf eine null-beendete 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 eine der folgenden: IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT oder IID_IUnknown.

[out] ppvObject

Typ: void**

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

Rückgabewert

Typ: STDAPI-

Wenn dies erfolgreich ist, wird S_OK zurückgegeben.

Wenn dies nicht erfolgreich ist, wird ein Standardmäßiger COM-Fehlercodezurückgegeben.

Bemerkungen

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 außer Kraft zu setzen, wenn sie ihren benutzerdefinierten Steuerelementen entsprechen. Alternativ können Serverentwickler dynamische Anmerkung verwenden, um bestimmte Eigenschaften außer Kraft zu setzen, ohne schwierige Unterklassentechniken verwenden zu müssen, die mit CreateStdAccessibleProxyerforderlich waren. Serverentwickler sollten weiterhin CreateStdAccessibleProxy- für strukturelle Änderungen verwenden, z. B. das Ausblenden eines untergeordneten Elements oder das Erstellen eines untergeordneten Platzhalterelements. Dieser Ansatz speichert Serverentwickler bei der vollständigen 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 CreateStdAccessibleProxy- ihnen ermöglicht, den Klassennamen als Parameter anzugeben.

Verwenden Sie CreateStdAccessibleProxy-, um ein barrierefreies Objekt für ein Benutzeroberflächenelement zu erstellen, das überklassigt ist. Wenn ein Benutzeroberflächenelement überklassigt ist, erstellt eine Anwendung ein benutzerdefiniertes Steuerelement mit einem Fensterklassennamen, der sich von dem vordefinierten Steuerelement unterscheidet, auf dem es basiert. Da der klassenname, der dem hwnd Parameter zugeordnet ist, der Name der Superklassenfensterklasse ist, geben Sie den Basisklassennamen (den Systemklassennamen, auf dem das übergeordnete Steuerelement basiert) in pszClassNamean.

Anmerkung

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
mindestens unterstützte Client-	Windows 2000 Professional [nur Desktop-Apps]
mindestens unterstützte Server-	Windows Server 2003 [Nur Desktop-Apps]
Zielplattform-	Fenster
Header-	oleacc.h
Library	Oleacc.lib
DLL-	Oleacc.dll
redistributable	Active Accessibility 1.3 RDK unter Windows NT 4.0 mit SP6 und höher und Windows 95

Siehe auch

Anhang A: Referenz zu unterstützten Benutzeroberflächenelementen

CreateStdAccessibleObject-

IDispatch-

Tastenkombinationen zum Verfügbarmachen von benutzerdefinierten Benutzeroberflächenelementen

Freigeben über