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

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

  • Статья

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

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

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

Правила и соглашения реализации

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

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

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

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

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

 

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