Поделиться через

Шаблон элемента управления SynchronizedInput

  • Статья

Описание рекомендаций и соглашений по реализации ISynchronizedInputProvider, включая сведения о свойствах и методах. Шаблон управления SynchronizedInput позволяет клиентским приложениям службы автоматизации пользовательского интерфейса Майкрософт направлять входные данные мыши или клавиатуры в определенный элемент пользовательского интерфейса.

Этот шаблон элемента управления обычно используется в автоматизированных скриптах тестирования для отправки входных данных мыши или клавиатуры в определенный элемент пользовательского интерфейса, а затем убедитесь, что элемент получил входные данные.

В этом разделе содержатся следующие разделы.

Рекомендации по реализации и соглашения

При реализации шаблона управления SynchronizedInput обратите внимание на следующие рекомендации и соглашения:

  • При вызове метода ISynchronizedInputProvider::StartListening поставщик службы автоматизации пользовательского интерфейса должен начать проверку ввода указанного типа, а затем выполнить одно из следующих действий:
    • При обнаружении соответствующих входных данных для элемента поставщик должен вызвать событие UIA_InputReachedTargetEventId.
    • При обнаружении совпадающих входных данных, но он достиг другого элемента, поставщик должен вызвать событие UIA_InputReachedOtherElementEventId.
    • При обнаружении несоответствия входных данных поставщик должен отменить входные данные и вызвать событие UIA_InputDiscardedEventId.
  • Поставщик автоматизации пользовательского интерфейса должен отменить входные данные, если он предназначен для элемента, отличного от текущего элемента.
  • Когда элемент получает входные данные или когда вызывается метод ISynchronizedInputProvider::Cancel, поставщик перестает проверять входные данные и продолжается как обычный.
  • Если вызывается ISynchronizedInputProvider::StartListening, когда поставщик уже прослушивает входные данные, поставщик должен вернуть UIA_E_INVALIDOPERATION.

Обязательные элементы для ISynchronizedInputProvider

Для реализации интерфейса ISynchronizedInputProvid er требуются следующие свойства, методы и события.

Обязательные элементы Тип элемента Примечания
StartListening Метод Никакой
Отмена Метод Никакой
UIA_InputReachedTargetEventId Событие Никакой

 

Обзор шаблонов элементов управления автоматизации пользовательского интерфейса