CreateStdAccessibleProxyA, fonction (oleacc.h)
Crée un objet accessible qui a les propriétés et 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
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), les contrôles prédéfinis (définis dans User32.dll) ou les é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 valeurs suivantes : IID_IAccessible, IID_IDispatch, IID_IEnumVARIANT ou IID_IUnknown.
[out] ppvObject
Type : void**
Adresse d’une variable de pointeur qui reçoit l’adresse de l’interface spécifiée.
Valeur de retour
Type : STDAPI
Si elle réussit, retourne S_OK.
Si elle ne réussit pas, 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 selon les besoins pour correspondre à leurs contrôles personnalisés. Vous pouvez également utiliser l’annotation dynamique pour remplacer des propriétés spécifiques sans avoir à utiliser des techniques de sous-classification difficiles 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’implémenter entièrement toutes les propriétés et méthodes IAccessible.
Cette fonction est similaire à
Utilisez CreateStdAccessibleProxy pour créer un objet accessible pour un élément d’interface utilisateur superclassé. Lorsqu’un élément d’interface utilisateur est superclassé, 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 la classe de fenêtre de superclasse, spécifiez le nom de classe de base (nom de classe système sur lequel le contrôle superclassé est basé) dans pszClassName.
Note
L’en-tête oleacc.h définit CreateStdAccessibleProxy comme 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. Le mélange 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.
Exigences
| Exigence | Valeur |
|---|---|
| client minimum pris en charge | Windows 2000 Professionnel [applications de bureau uniquement] |
| serveur minimum pris en charge | Windows Server 2003 [applications de bureau uniquement] |
| plateforme cible | Windows |
| d’en-tête | oleacc.h |
| bibliothèque | Oleacc.lib |
| DLL | Oleacc.dll |
| 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
raccourcis pour exposer des éléments d’interface utilisateur personnalisés