CreateStdAccessibleProxyA-Funktion (oleacc.h)

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

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

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.

Anforderungen

Weitere Informationen

Anhang A: Referenz zu unterstützten Benutzeroberflächenelementen

CreateStdAccessibleObject

IDispatch

Tastenkombinationen zum Verfügbarmachen benutzerdefinierter Benutzeroberflächenelemente