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
- Erforderliche Member für ISynchronizedInputProvider-
- Verwandte Themen
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 |
Verwandte Themen