GesynchroniseerdInput-besturingselementpatroon

Beschrijft richtlijnen en conventies voor het implementeren van ISynchronizedInputProvider, inclusief informatie over eigenschappen en methoden. Met het SyncdInput--besturingspatroon kunnen Microsoft UI Automation-clienttoepassingen de muis- of toetsenbordinvoer naar een specifiek UI-element leiden.

Dit besturingspatroon wordt meestal gebruikt in geautomatiseerde testscripts om muis- of toetsenbordinvoer naar een specifiek element van de gebruikersinterface te verzenden en controleer vervolgens of het element de invoer heeft ontvangen.

Dit onderwerp bevat de volgende secties.

• richtlijnen en conventies voor de tenuitvoerlegging
• Vereiste leden voor ISynchronizedInputProvider
• Verwante onderwerpen

Implementatierichtlijnen en conventies

Let bij het implementeren van het SyncdInput controlepatroon op de volgende richtlijnen en conventies:

• Wanneer de methode ISynchronizedInputProvider::StartListening wordt aangeroepen, moet de UI Automation-provider beginnen met controleren op invoer van het opgegeven type en vervolgens een van de volgende acties uitvoeren:
  • Wanneer overeenkomende invoer voor het element wordt gevonden, moet de provider de UIA_InputReachedTargetEventId gebeurtenis genereren.
  • Wanneer overeenkomende invoer wordt gevonden, maar er een ander element is bereikt, moet de provider de UIA_InputReachedOtherElementEventId gebeurtenis genereren.
  • Wanneer niet-overeenkomende invoer wordt gevonden, moet de provider de invoer negeren en de UIA_InputDiscardedEventId gebeurtenis genereren.
• De UI Automation-provider moet de invoer negeren als dit voor een ander element is dan het huidige element.
• Wanneer het element de invoer ontvangt of wanneer de methode ISynchronizedInputProvider::Cancel wordt aangeroepen, stopt de provider met het controleren van de invoer en gaat deze verder als normaal.
• Als ISynchronizedInputProvider::StartListening wordt aangeroepen wanneer de provider al naar invoer luistert, moet de provider UIA_E_INVALIDOPERATIONretourneren.

Vereiste leden voor ISynchronizedInputProvider

De volgende eigenschappen, methoden en gebeurtenissen zijn vereist voor het implementeren van de ISynchronizedInputProvider interface.

Verwante onderwerpen

Overzicht van UI Automation-besturingspatronen