SynchronizedInput-Steuerelementmuster

Beschreibt Richtlinien und Konventionen für die Implementierung von ISynchronizedInputProvider, einschließlich Informationen zu Eigenschaften und Methoden. Das SynchronizedInput-Steuerelementmuster ermöglicht Es Microsoft Benutzeroberflächenautomatisierung Clientanwendungen, die Maus- oder Tastatureingabe an ein bestimmtes UI-Element zu leiten.

Dieses Steuerelementmuster wird in der Regel in automatisierten Testskripts verwendet, um Maus- oder Tastatureingaben an ein bestimmtes Benutzeroberflächenelement zu senden und dann zu überprüfen, ob das Element die Eingabe empfangen hat.

Dieses Thema enthält folgende Abschnitte:

• Implementierungsrichtlinien und -konventionen
• Erforderliche Member für ISynchronizedInputProvider
• Zugehörige Themen

Implementierungsrichtlinien und -konventionen

Beachten Sie beim Implementieren des SynchronizedInput-Steuerelementmusters die folgenden Richtlinien und Konventionen:

• Wenn die ISynchronizedInputProvider::StartListening-Methode aufgerufen wird, sollte der Benutzeroberflächenautomatisierung Anbieter mit der Überprüfung auf Eingaben des angegebenen Typs beginnen und dann eine der folgenden Aktionen ausführen:
  • Wenn eine übereinstimmende Eingabe für das -Element gefunden wird, sollte der Anbieter das UIA_InputReachedTargetEventId-Ereignis auslösen.
  • Wenn eine übereinstimmende Eingabe gefunden, aber ein anderes Element erreicht wurde, sollte der Anbieter das UIA_InputReachedOtherElementEventId-Ereignis auslösen.
  • Wenn eine nicht übereinstimmende Eingabe gefunden wird, sollte der Anbieter die Eingabe verwerfen und das UIA_InputDiscardedEventId-Ereignis auslösen.
• Der Benutzeroberflächenautomatisierung Anbieter muss die Eingabe verwerfen, wenn es sich um ein anderes Element als das aktuelle Element handelt.
• Wenn das Element die Eingabe empfängt oder die ISynchronizedInputProvider::Cancel-Methode aufgerufen wird, beendet der Anbieter die Überprüfung der Eingabe und fährt wie gewohnt fort.
• Wenn ISynchronizedInputProvider::StartListening aufgerufen wird, wenn der Anbieter bereits auf Eingabe lauscht, sollte der Anbieter UIA_E_INVALIDOPERATION zurückgeben.

Erforderliche Member für ISynchronizedInputProvider

Die folgenden Eigenschaften, Methoden und Ereignisse sind für die Implementierung der ISynchronizedInputProvider-Schnittstelle erforderlich.

Erforderliche Member	Memberart	Hinweise
StartListening	Methode	Keine
Abbrechen	Methode	Keine
UIA_InputReachedTargetEventId	Ereignis	Keine

 

Zugehörige Themen

Übersicht über Steuerelementmuster für Benutzeroberflächenautomatisierung