Modèle de contrôle SynchrondInput

Décrit des instructions et des conventions pour l’implémentation d’ISynchronizedInputProvider, y compris des informations sur les propriétés et les méthodes. Le modèle de contrôle SynchronizedInput permet aux applications clientes Microsoft UI Automation de diriger l’entrée de la souris ou du clavier vers un élément d’interface utilisateur spécifique.

Ce modèle de contrôle est généralement utilisé dans les scripts de test automatisés pour envoyer une entrée de souris ou de clavier à un élément d’interface utilisateur spécifique, puis vérifier que l’élément a reçu l’entrée.

Cette rubrique contient les sections suivantes.

• Conventions et directives d'implémentation
• Membres requis pour ISynchronizedInputProvider
• Rubriques connexes

Conventions et directives d'implémentation

Lors de l’implémentation du modèle de contrôle SynchronizedInput , notez les directives et conventions suivantes :

• Lorsque la méthode ISynchronizedInputProvider::StartListening est appelée, le fournisseur de UI Automation doit commencer à rechercher l’entrée du type spécifié, puis effectuer l’une des actions suivantes :
  • Lorsque l’entrée correspondante est trouvée pour l’élément, le fournisseur doit déclencher l’événement UIA_InputReachedTargetEventId .
  • Lorsque l’entrée correspondante est trouvée, mais qu’elle a atteint un autre élément, le fournisseur doit déclencher l’événement UIA_InputReachedOtherElementEventId .
  • En cas de non-correspondance d’entrée, le fournisseur doit ignorer l’entrée et déclencher l’événement UIA_InputDiscardedEventId .
• Le fournisseur UI Automation doit ignorer l’entrée s’il s’agit d’un élément autre que l’élément actuel.
• Lorsque l’élément reçoit l’entrée ou lorsque la méthode ISynchronizedInputProvider::Cancel est appelée, le fournisseur arrête la vérification de l’entrée et continue normalement.
• Si ISynchronizedInputProvider::StartListening est appelé lorsque le fournisseur écoute déjà l’entrée, le fournisseur doit retourner UIA_E_INVALIDOPERATION.

Membres requis pour ISynchronizedInputProvider

Les propriétés, méthodes et événements suivants sont nécessaires pour implémenter l’interface ISynchronizedInputProvider .

Membres nécessaires	Type de membre	Notes
StartListening	Méthode	Aucun
Annuler	Méthode	Aucun
UIA_InputReachedTargetEventId	Événement	Aucun

 

Rubriques connexes

Vue d'ensemble des modèles de contrôle UI Automation