Modèle de contrôle SynchrondInput

Décrit les instructions et conventions d’implémentation 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 souris ou 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.

• directives et conventions de mise en œuvre
• membres obligatoires pour ISynchronizedInputProvider
• rubriques connexes

Directives et conventions de mise en œuvre

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

• Lorsque la méthode ISynchronizedInputProvider ::StartListening est appelée, le fournisseur UI Automation doit commencer à vérifier 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.
  • Lorsque l’entrée incompatible est trouvé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 de vérifier 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 obligatoires pour ISynchronizedInputProvider

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

Rubriques connexes

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