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