Freigeben über


SynchronizedInput-Steuerelementmuster

Beschreibt Richtlinien und Konventionen für die Implementierung von ISynchronizedInputProvider-, einschließlich Informationen zu Eigenschaften und Methoden. Mit dem SynchronizedInput Steuerelementmusters können Microsoft-Benutzeroberflächenautomatisierungs-Clientanwendungen die Maus- oder Tastatureingabe an ein bestimmtes UI-Element weiterleiten.

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 erhalten hat.

Dieses Thema enthält die folgenden Abschnitte.

Implementierungsrichtlinien und -konventionen

Beachten Sie bei der Implementierung des SynchronizedInput- Steuerelementmusters die folgenden Richtlinien und Konventionen:

  • Wenn die ISynchronizedInputProvider::StartListening--Methode aufgerufen wird, sollte der Benutzeroberflächenautomatisierungs-Anbieter mit der Überprüfung der Eingabe des angegebenen Typs beginnen und dann eine der folgenden Aktionen ausführen:
    • Wenn übereinstimmende Eingaben für das Element gefunden werden, sollte der Anbieter das UIA_InputReachedTargetEventId-Ereignis auslösen.
    • Wenn übereinstimmende Eingaben gefunden werden, aber ein anderes Element erreicht wurde, sollte der Anbieter das UIA_InputReachedOtherElementEventId-Ereignis auslösen.
    • Wenn nicht übereinstimmende Eingaben gefunden werden, sollte der Anbieter die Eingabe verwerfen und das UIA_InputDiscardedEventId-Ereignis auslösen.
  • Der Benutzeroberflächenautomatisierungs-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 wenn die ISynchronizedInputProvider::Cancel-Methode aufgerufen wird, beendet der Anbieter die Überprüfung der Eingabe und wird normal fortgesetzt.
  • Wenn ISynchronizedInputProvider::StartListening aufgerufen wird, wenn der Anbieter bereits auf Eingabe lauscht, sollte der Anbieter UIA_E_INVALIDOPERATIONzurückgeben.

Erforderliche Elemente für ISynchronizedInputProvider-

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

Erforderliche Mitglieder Elementtyp Notizen
StartListening- Methode Nichts
abbrechen Methode Nichts
UIA_InputReachedTargetEventId Ereignis Nichts

 

Übersicht über Steuerelementmuster für die Benutzeroberflächenautomatisierung