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

Метод IUIAutomation6::RemoveActiveTextPositionChangedEventHandler (uiautomationclient.h)

  • Статья

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

Важно!

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

Синтаксис

HRESULT RemoveActiveTextPositionChangedEventHandler(
  [in] IUIAutomationElement                               *element,
  [in] IUIAutomationActiveTextPositionChangedEventHandler *handler
);

Параметры

[in] element

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

[in] handler

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

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

Этот метод не возвращает значение.

Комментарии

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

Активное положение текста обозначается событием навигации в текстовых элементах только для чтения или между ними (например, веб-браузеры, документы в формате 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.

Событие может быть доставлено обработчику событий после отмены подписки обработчика, если событие получено одновременно с запросом на отмену подписки на событие. Рекомендуется следовать стандарту COM и избегать уничтожения объекта обработчика событий до тех пор, пока его количество ссылок не достигнет нуля. Удаление обработчика событий сразу после отмены подписки на события может привести к нарушению доступа, если событие доставляется с опозданием.

Требования

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

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

IUIAutomation6::AddActiveTextPositionChangedEventHandler, интерфейс IUIAutomation6