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

Метод IUIAutomationEventHandlerGroup::AddActiveTextPositionChangedEventHandler (uiautomationclient.h)

  • Статья

Регистрирует метод (в группе обработчиков событий), который обрабатывает изменение активной позиции текста.

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

 

Синтаксис

HRESULT AddActiveTextPositionChangedEventHandler(
  [in] TreeScope                                          scope,
  [in] IUIAutomationCacheRequest                          *cacheRequest,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

Параметры

[in] scope

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

[in] cacheRequest

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

[in] handler

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

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

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

Комментарии

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

Активное положение текста обозначается событием навигации в текстовых элементах только для чтения или между ними (например, веб-браузеры, документы в формате PDF или документы EPUB ) с помощью закладок (или идентификаторов фрагментов для ссылки на расположение в ресурсе). Примеры приведены ниже.

  • Переход к закладке на той же веб-странице
  • Переход к закладке на другой веб-странице
  • Активация ссылки на другое расположение в том же PDF-файле
  • Активация ссылки на другое расположение в том же EPUB
Используйте этот обработчик событий для синхронизации визуального расположения закладки или целевого объекта с расположением фокуса в текстовом элементе только для чтения, который может отличаться при использовании закладок или идентификаторов фрагментов.

Например, при вызове той же привязки страницы (<a href=”#C4”>Jump to Chapter 4</a> ... <h1><a name="C4">Chapter 4</a></h1>) расположение визуального элемента обновляется, но клиент модель автоматизации пользовательского интерфейса остается в исходном расположении. Это приводит к таким действиям, как чтение текста или перемещение следующего элемента, начиная с исходного расположения, а не из нового расположения.

Аналогичным образом активация нового URI страницы (с идентификатором фрагмента: (<a href=”www.blah.com#C4”>Jump to Chapter 4</a>)) загружает новую страницу и переходит к указанной закладке, но оставляет клиенты модель автоматизации пользовательского интерфейса в верхней части страницы.

Для редактируемых текстовых элементов, таких как элементы управления Edit и Rich Edit , можно прослушивать событие SelectionChanged.

Требования

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

См. также раздел

IUIAutomationEventHandlerGroup