EvtTracker (Отслеживание Событий)

Event Tracker

• Авторы: Joseph Lee, Thiago Seus

Дополнение EvtTracker выводит информацию об объектах, для которых были вызваны события. В режиме отладочного журнала записываются такие свойства, как тип объекта, имя, роль, событие, модуль приложения и специфическая для API доступности информация, такая как accName для объектов IAccessible и Automation Id для объектов UIA.

Примечания:

• Это дополнение предназначено для разработчиков и опытных пользователей, которым необходимо отслеживать события, поступающие от приложений и различных элементов управления.
• Для использования дополнения NVDA должен вести журнал в режиме отладки (настраивается в общих настройках/уровень ведения журнала или перезапуск с включённым отладочным журналом).
• Возможно, что дополнения, загруженные раньше Event Tracker, могут не передавать событие другим дополнениям, включая Event Tracker. В этом случае Event Tracker не сможет записать события.
• События обрабатываются в следующем порядке: глобальные плагины, модули приложений, перехватчики дерева и объекты NVDA.

События и их информация

Отслеживаются и записываются следующие события:

• Манипуляции с фокусом: получение фокуса, потеря фокуса, вход фокуса, передний план
• Изменения: имени, значения, состояния, описания, области live-региона
• Другие события: оповещение
• События UIA: контроллер для, эффекты перетаскивания и цели сброса, выбранный элемент, статус элемента, недействительная компоновка, уведомление, системное оповещение, изменение текста, открытие подсказки, открытие окна

Для каждого события записывается следующая информация:

• Имя события
• Объект
• Имя объекта
• Роль объекта
• Значение или состояние объекта в зависимости от событий
• Модуль приложения
• Для объектов IAccessible: acc name, ID дочернего элемента
• Для объектов UIA: Automation Id, имя класса, свойства уведомления (если записывается информация о событии уведомления), количество дочерних элементов для события недействительной компоновки, свойства для статуса элемента, перетаскивания и эффекта цели сброса (если определены)

Вы также можете назначить жест для просмотра событий в списке (меню NVDA/Параметры/Жесты ввода, категория Event Tracker). Список сохраняет до 100 последних обработанных событий.

Если вы находите это дополнение полезным, пожалуйста, оставьте отзыв в NVDA Add-on Store.

Версия 26.2.0

• Требуется NVDA 2025.3.3 или новее.

Версия 26.1.0

• В диалоге со списком событий больше не отображается некорректная информация для описания последнего события, если диалог был открыт длительное время.
• Текст эффекта цели перетаскивания UIA извлекается из родительского объекта фокуса, если объект UIA, вызвавший это событие, не содержит данной информации.

Версия 25.1.0

• Совместимость с NVDA 2025.1.
• Требуется NVDA 2024.1 или новее из-за перехода на Python 3.11.
• Восстановлена ограниченная поддержка Windows 8.1.
• Код дополнения стал более надежным благодаря Pyright (статическому анализатору типов Python).
• NVDA теперь записывает фактическое название роли элемента вместо чисел при отчете о событиях.

Версия 24.1.0

• Совместимость с NVDA 2024.1.
• opensourcesys/evtTracker #4: исправлено отсутствие описания первого события при первом открытии просмотрщика событий. Вклад: WangFeng Huang (hwf1324)

Версия 23.02

• Требуется NVDA 2022.4 или новее.
• Требуется Windows 10 21H2 (ноябрьское обновление 2021 года/сборка 19044) или новее.
• Добавлено отслеживание события оповещения (в основном для объектов IAccessible).

Версия 23.01

• Требуется NVDA 2022.3 или новее.
• Требуется Windows 10 или новее, так как Windows 7, 8 и 8.1 больше не поддерживаются Microsoft с января 2023 года.

Версия 22.12

• Добавлено диалоговое окно списка событий (команда не назначена) для отображения до 100 последних событий, записанных дополнением (Thiago Seus).
• Дополнительная информация о событиях, такая как свойства уведомлений UIA, теперь записывается одновременно с событиями.

Версия 22.10

• Требуется NVDA 2022.2 или новее по соображениям безопасности.
• Добавлено отслеживание следующих изменений свойств UIA: эффект перетаскивания, эффект цели сброса.
• Записывается текст свойства статуса элемента UIA.
• NVDA больше не будет воспроизводить звуки ошибок или казаться бездействующим, если объект не определяет имя класса окна.

Версия 22.06

• Требуется NVDA 2021.3 или новее по соображениям безопасности.

Версия 21.10

• Требуется NVDA 2021.2 или новее из-за изменений в NVDA, влияющих на это дополнение.
• Добавлено отслеживание события недействительной компоновки UIA.
• Информация о роли и состояниях объекта теперь соответствует информации для разработчиков в более новых версиях NVDA.

Версия 21.07

• Первый выпуск.