Отслеживание событий

• Автор: Джозеф Ли, Тьяго Сеус
• Скачать стабильную версию
• Совместимость с NVDA: 2022.4 и более новая версии

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

Примечания:

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

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

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

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

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

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

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

Перевод

• Валентин Куприянов. Подключил перевод в целом и фразы для подкатегории в жестах ввода.

Журнал версий

Версия 23.02

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

Версия 23.01

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

Версия 22.12

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

Версия 22.10

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

Версия 22.06

• Для обеспечения безопасности требуется NVDA 2021.3 или более поздняя версия.

Версия 21.10

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

Версия 21.07

• Первоначальный выпуск.