CreateStdAccessibleProxyA, fonction (oleacc.h)

Crée un objet accessible qui a les propriétés et les méthodes de la classe spécifiée de l’élément d’interface utilisateur fourni par le système.

Syntaxe

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

Paramètres

[in] hwnd

Type : HWND

Handle de fenêtre de l’élément d’interface utilisateur fourni par le système (contrôle) pour lequel un objet accessible est créé.

[in] pClassName

Type : LPCTSTR

Pointeur vers une chaîne terminée par null du nom de classe d’un élément d’interface utilisateur fourni par le système pour lequel un objet accessible est créé. Le nom de la classe de fenêtre est l’un des contrôles courants (définis dans Comctl32.dll), des contrôles prédéfinis (définis dans User32.dll) ou des éléments de fenêtre.

[in] idObject

Type : LONG

ID d'objet. Cette valeur est généralement OBJID_CLIENT, qui est l’une des constantes d’identificateur d’objet, mais il peut s’agir d’un autre identificateur d’objet.

[in] riid

Type : REFIID

Identificateur de référence de l’interface demandée. Cette valeur est l’une des suivantes : IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT ou IID_IUnknown.

[out] ppvObject

Type : void**

Adresse d’une variable pointeur qui reçoit l’adresse de l’interface spécifiée.

Valeur retournée

Type : STDAPI

En cas de réussite, retourne S_OK.

En cas d’erreur, retourne un code d’erreur COM standard.

Remarques

Les applications serveur appellent cette fonction lorsqu’elles contiennent un contrôle personnalisé similaire à un contrôle fourni par le système. Les applications serveur peuvent appeler CreateStdAccessibleProxy pour remplacer les méthodes et propriétés IAccessible en fonction des besoins pour correspondre à leurs contrôles personnalisés. Les développeurs de serveurs peuvent également utiliser l’annotation dynamique pour remplacer des propriétés spécifiques sans avoir à utiliser des techniques de sous-classification difficiles qui étaient requises avec CreateStdAccessibleProxy. Les développeurs de serveurs doivent toujours utiliser CreateStdAccessibleProxy pour les modifications structurelles, telles que le masquage d’un élément enfant ou la création d’un élément enfant d’espace réservé. Cette approche permet aux développeurs de serveurs d’économiser le travail d’implémentation complète de toutes les propriétés et méthodes IAccessible .

Cette fonction est similaire à CreateStdAccessibleObject, sauf que CreateStdAccessibleObject utilise toujours le nom de classe associé au hwnd , tandis que CreateStdAccessibleProxy vous permet de spécifier le nom de la classe en tant que paramètre.

Utilisez CreateStdAccessibleProxy pour créer un objet accessible pour un élément d’interface utilisateur qui est surclassé. Lorsqu’un élément d’interface utilisateur est surclassé, une application crée un contrôle personnalisé avec un nom de classe de fenêtre différent du contrôle prédéfini sur lequel il est basé. Étant donné que le nom de classe associé au paramètre hwnd est le nom de classe de la fenêtre de superclasse, spécifiez le nom de la classe de base (le nom de classe système sur lequel le contrôle surclassé est basé) dans pszClassName.

Notes

L’en-tête oleacc.h définit CreateStdAccessibleProxy en tant qu’alias qui sélectionne automatiquement la version ANSI ou Unicode de cette fonction en fonction de la définition de la constante de préprocesseur UNICODE. La combinaison de l’utilisation de l’alias neutre en encodage avec du code qui n’est pas neutre en encodage peut entraîner des incompatibilités qui entraînent des erreurs de compilation ou d’exécution. Pour plus d’informations, consultez Conventions pour les prototypes de fonction.

Configuration requise

Condition requise	Valeur
Client minimal pris en charge	Windows 2000 Professionnel [applications de bureau uniquement]
Serveur minimal pris en charge	Windows Server 2003 [applications de bureau uniquement]
Plateforme cible	Windows
En-tête	oleacc.h
Bibliothèque	Oleacc.lib
DLL	Oleacc.dll
Composant redistribuable	Active Accessibility 1.3 RDK sur Windows NT 4.0 avec SP6 et versions ultérieures et Windows 95

Voir aussi

Annexe A : Informations de référence sur les éléments d’interface utilisateur pris en charge

CreateStdAccessibleObject

IDispatch

Raccourcis pour exposer des éléments d’interface utilisateur personnalisés