Partager via


Obtention d’un pointeur d’interface objet accessible

Les applications clientes Microsoft Active Accessibility récupèrent des pointeurs d’interface vers des objets accessibles à l’aide de l’une des fonctions suivantes.

ObjetAccessibleDepuisÉvénement

De nombreux clients recherchent des informations sur des objets accessibles spécifiques qui génèrent des événements. Étant donné que l’interface IAccessible est la « passerelle » pour les objets accessibles, les clients doivent avoir un moyen simple d’associer WinEvents à l’interface IAccessible de l’objet générant les événements. Microsoft Active Accessibility fournit la fonction AccessibleObjectFromEvent spécifiquement à cet effet.

Remarque

Les clients disposant de fonctions de hook in-context doivent appeler la fonction IsWindow avant d’appeler AccessibleObjectFromEvent.

 

La fonction AccessibleObjectFromEvent accepte une grande partie des mêmes informations que la fonction de hook d’un client reçoit. Lorsqu’une fonction de hook client reçoit une notification d’événement, elle transmet les paramètres appropriés des événements à AccessibleObjectFromEvent.

La fonction récupère l’interface IAccessible de l’élément d’interface utilisateur qui a généré l’événement ou l’interface de l’objet parent de l’élément. Si le pointeur d’interface de l’objet parent est retourné, le client appelle les propriétés et méthodes du parent pour obtenir des informations sur l’élément enfant qui a généré l’événement.

AccessibleObjectFromPoint

Pour récupérer l’adresse de l’interface IAccessible d’un objet à un point spécifié à l’écran, les clients utilisent la fonction AccessibleObjectFromPoint .

AccessibleObjectFromWindow

Pour récupérer l’interface IAccessible d’un objet à partir d’un handle de fenêtre, les clients utilisent la fonction AccessibleObjectFromWindow .

Il est possible que les serveurs retournent des pointeurs d’interface distincts pour le même élément d’interface utilisateur chaque fois que la fonction AccessibleObjectFromEvent, AccessibleObjectFromPoint ou AccessibleObjectFromWindow est appelée. Pour déterminer si deux pointeurs font référence au même élément d’interface utilisateur, les développeurs clients doivent comparer les propriétés IAccessible de l’objet, et non les pointeurs.