SyncdInput, wzorzec kontrolki

Opisuje wytyczne i konwencje implementowania ISynchronizedInputProvider, w tym informacje o właściwościach i metodach. Wzorzec sterowania SyncdInput umożliwia aplikacjom klienckim automatyzacji interfejsu użytkownika firmy Microsoft kierowanie myszy lub klawiatury do określonego elementu interfejsu użytkownika.

Ten wzorzec sterowania jest zwykle używany w skryptach testów automatycznych do wysyłania danych wejściowych myszy lub klawiatury do określonego elementu interfejsu użytkownika, a następnie sprawdź, czy element otrzymał dane wejściowe.

Ten temat zawiera następujące sekcje.

• wytyczne i konwencje implementacji
• wymagane elementy członkowskie ISynchronizedInputProvider
• Tematy pokrewne

Wytyczne i konwencje implementacji

Podczas implementowania wzorca kontrolki SyncdInput należy pamiętać o następujących wytycznych i konwencjach:

• Po wywołaniu metody ISynchronizedInputProvider::StartListening dostawca automatyzacji interfejsu użytkownika powinien rozpocząć sprawdzanie danych wejściowych określonego typu, a następnie wykonać jedną z następujących akcji:
  • Po znalezieniu pasujących danych wejściowych dla elementu dostawca powinien zgłosić zdarzenie UIA_InputReachedTargetEventId.
  • Po znalezieniu pasujących danych wejściowych, ale osiągnął inny element, dostawca powinien zgłosić zdarzenie UIA_InputReachedOtherElementEventId.
  • Po znalezieniu niezgodnych danych wejściowych dostawca powinien odrzucić dane wejściowe i zgłosić zdarzenie UIA_InputDiscardedEventId.
• Dostawca automatyzacji interfejsu użytkownika musi odrzucić dane wejściowe, jeśli jest to element inny niż bieżący element.
• Gdy element odbiera dane wejściowe lub gdy wywoływana jest metoda ISynchronizedInputProvider::Cancel, dostawca zatrzymuje sprawdzanie danych wejściowych i kontynuuje działanie w normalny sposób.
• Jeśli ISynchronizedInputProvider::StartListening jest wywoływany, gdy dostawca już nasłuchuje danych wejściowych, dostawca powinien zwrócić UIA_E_INVALIDOPERATION.

Wymagane elementy członkowskie ISynchronizedInputProvider

Następujące właściwości, metody i zdarzenia są wymagane do zaimplementowania interfejsu ISynchronizedInputProvider.

Wymagane elementy członkowskie	Typ elementu członkowskiego	Notatki
StartListening	Metoda	Żaden
Anuluj	Metoda	Żaden
UIA_InputReachedTargetEventId	Zdarzenie	Żaden

 

Tematy pokrewne

Wzorce kontrolek automatyzacji interfejsu użytkownika — omówienie