Vue d'ensemble des événements UI Automation

  • Article

La notification d’événement Microsoft UI Automation est une fonctionnalité clé pour les technologies d’assistance, telles que les lecteurs d’écran et les loupes d’écran. Ces clients UI Automation suivent les événements déclenchés par les fournisseurs UI Automation quand quelque chose se produit dans l’interface utilisateur, et utilisent les informations pour avertir les utilisateurs finaux.

L'efficacité est améliorée en permettant aux applications fournisseurs de déclencher des événements de manière sélective, selon que des clients sont abonnés à ces événements ou non, si aucun client n'écoute d'événement.

Les événements UI Automation s’inscrivent dans les catégories suivantes.

Catégorie d'événement Description
Modification de propriété Déclenché lorsqu’une propriété sur UI Automation élément ou le modèle de contrôle change. Par exemple, si un client doit surveiller une application case activée contrôle box, il peut s’inscrire pour écouter un événement de modification de propriété sur la propriété IUIAutomationTogglePattern::CurrentToggleState. Quand le contrôle de case à cocher est coché ou décoché, le fournisseur déclenche l'événement et le client peut agir de manière appropriée.
Action d'élément Déclenché lorsqu’une modification de l’interface utilisateur résulte d’une activité de l’utilisateur final ou d’une activité programmatique, par exemple lorsqu’un clic sur un bouton est cliqué ou appelé via IUIAutomationInvokePattern.
Modification de la structure Déclenchée quand la structure de l’arborescence UI Automation change. La structure évolue quand de nouveaux éléments de l’interface utilisateur deviennent visibles, sont masqués ou sont supprimés sur le Bureau.
Modification globale du bureau Déclenché quand des actions d'intérêt global pour le client se produisent, par exemple quand le focus passe d'un élément à un autre ou qu'une fenêtre se ferme.
Notification Déclenché lorsqu’une application appelle la fonction UiaRaiseNotificationEvent . NotificationKind indique le type de notification.

 

Certains événements ne signifient pas nécessairement que l'état de l'interface utilisateur a changé. Par exemple, si l’utilisateur affiche un champ d’entrée de texte par tabulation, puis clique sur un bouton pour mettre à jour le champ, un événement UIA_Text_TextChangedEventId est déclenché, même si l’utilisateur n’a pas réellement modifié le texte. Pendant le traitement d'un événement, une application cliente peut être amenée à vérifier ce qui a réellement changé avant d'agir.

Les événements suivants peuvent être déclenchés même quand l'état de l'interface utilisateur n'a pas changé.

Pour obtenir une description de tous les événements UI Automation, consultez Identificateurs d’événements.

Abonnement aux événements UI Automation