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

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

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

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

• Правила и соглашения реализации
• Обязательные элементы для ISynchronizedInputProvider
• Связанные темы

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

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

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

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

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

Связанные темы

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