Метод IUIAutomation3::AddTextEditTextChangedEventHandler (uiautomationclient.h)

Статья
03/03/2024

Регистрирует метод, обрабатывающий программные события редактирования текста.

Примечание Перед реализацией обработчика событий необходимо ознакомиться с проблемами потоков, описанными в разделе Основные сведения о проблемах с потоками.

Синтаксис

HRESULT AddTextEditTextChangedEventHandler(
  [in] IUIAutomationElement                         *element,
  [in] TreeScope                                    scope,
  [in] TextEditChangeType                           textEditChangeType,
  [in] IUIAutomationCacheRequest                    *cacheRequest,
  [in] IUIAutomationTextEditTextChangedEventHandler *handler
);

Параметры

[in] element

Тип: IUIAutomationElement*

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

[in] scope

Тип: TreeScope

Область обрабатываемых событий; т.е. находятся ли они в самом элементе или в его предках и потомках.

[in] textEditChangeType

Тип: TextEditChangeType

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

[in] cacheRequest

Тип: IUIAutomationCacheRequest*

Указатель на запрос кэша или значение NULL , если кэширование не требуется.

[in] handler

Тип: IUIAutomationTextEditTextChangedEventHandler*

Указатель на объект , обрабатывающий событие программного изменения текста.

Возвращаемое значение

Тип: HRESULT

Если этот метод завершается успешно, он возвращает S_OK. В противном случае возвращается код ошибки HRESULT .

Клиент модель автоматизации пользовательского интерфейса не должен использовать несколько потоков для добавления или удаления обработчиков событий. Может возникнуть непредвиденное поведение, если один обработчик событий добавляется или удаляется, а другой добавляется или удаляется в том же клиентском процессе.

Требования

Требование	Значение
Минимальная версия клиента	Windows 8.1 [только классические приложения]
Минимальная версия сервера	Windows Server 2012 R2 [только классические приложения]
Целевая платформа	Windows
Header	uiautomationclient.h (включая UIAutomation.h)