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 Benutzeroberflächenelement 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 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 Suche nach 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 ausgelöst.
- Wenn eine übereinstimmende Eingabe gefunden wird, aber ein anderes Element erreicht wurde, sollte der Anbieter das UIA _ InputReachedOtherElementEventId-Ereignis ausgelöst.
- Wenn nicht übereinstimmende Eingaben gefunden werden, sollte der Anbieter die Eingabe verwerfen und das UIA _ InputDiscardedEventId-Ereignis ausgelöst.
- Der Benutzeroberflächenautomatisierung muss die Eingabe verwerfen, wenn sie für ein anderes Element als das aktuelle Element gilt.
- Wenn das Element die Eingabe empfängt oder wenn 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 Eingaben lauselt, 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 |