Event Tracker (Відстежувач подій)

Event Tracker

Цей додаток виводить інформацію про об’єкти, для яких було розпочато події. Властивості, записані в режимі журналу налагодження, включають тип об’єкта, ім’я, роль, подію, модуль програми та інформацію API спеціальних можливостей, таку як accName для об’єкта IAccessible та ідентифікатор автоматизації для об’єктів UIA.

Примітки:

  • Цей додаток призначений для розробників і досвідчених користувачів, яким потрібно відстежувати події, що надходять з програм та різних елементів керування.
  • Щоб використовувати додаток, NVDA повинна вести журнал у режимі налагодження (налаштовується у загальних налаштуваннях/рівень запису в журнал або перезапустіть NVDA з увімкненим журналом звіту на рівні налагодження.
  • Можливо, додатки, завантажені раніше за Event Tracker, можуть не передавати подію іншим додаткам, включно з Event Tracker. Якщо це станеться, Event Tracker не зможе відстежувати події.
  • Події обробляються з глобальних плагінів, модулів програм, перехоплювачів дерев та об’єктів NVDA у такому порядку.

Події та інформація про них

Відстежуються і записуються такі події:

  • Маніпуляція фокусом: отримання фокусу, втрата фокусу, введення фокусу, передній план
  • Зміни: ім’я, значення, стан, опис, інтерактивна область (live region)
  • Other events: alert
  • UIA events: controller for, drag drop and drop target effects, element selected, item status, layout invalidated, notification, system alert, text change, tooltip open, window open

Для кожної події записується така інформація:

  • Ім’я події
  • Об’єкт
  • Ім’я об’єкта
  • Роль об’єкта
  • Значення або стан об’єкта, залежно від подій
  • Модуль програми
  • Для об’єктів IAccessible: acc name, child ID
  • For UIA objects: Automation Id, class name, notification properties if recording notification event information, child count for layout invalidated event, properties for item status, drag drop, and drop target effect if defined

You can also assign a gesture to view the events on a list (NVDA menu/Preferences/Input gestures, Event Tracker category). The list saves up to 100 latest events processed.

If you find this add-on useful, please review it in the NVDA Add-on Store.

Version 24.1.0

  • NVDA 2024.1 compatibility.

Version 23.02

  • NVDA 2022.4 or later is required.
  • Windows 10 21H2 (November 2021 Update/build 19044) or later is required.
  • Alert event (mostly for IAccessible objects) will be tracked.

Version 23.01

  • NVDA 2022.3 or later is required.
  • Windows 10 or later is required as Windows 7, 8, and 8.1 are no longer supported by Microsoft as of January 2023.

Version 22.12

  • Added events list dialog (command unassigned) to list up to 100 recent events recorded by the add-on (Thiago Seus).
  • Additional event information such as UIA notification properties are recorded at the same time as events.

Version 22.10

  • NVDA 2022.2 or later is required due to security.
  • The following UIA property changes are tracked: drag drop effect, drop target effect.
  • UIA item status property text is logged.
  • NVDA will no longer play error tones or appear to do nothing if an object does not define a window class name.

Version 22.06

  • NVDA 2021.3 or later is required due to security.

Version 21.10

  • NVDA 2021.2 or later is required due to changes to NVDA that affects this add-on.
  • UIA layout invalidated event will be tracked.
  • Object role and states information will resemble developer info found in more recent NVDA releases.

Версія 21.07

  • Перша версія.