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

Средства специальных возможностей — AccEvent (наблюдатель за событиями со специальными возможностями)

  • Статья

AccEvent (Наблюдатель за событиями со специальными возможностями) позволяет разработчикам и тестировщикам проверять, что элементы пользовательского интерфейса приложения вызывают надлежащие события службы автоматизации пользовательского интерфейса Майкрософт и microsoft Active Accessibility при изменении пользовательского интерфейса. Изменения в пользовательском интерфейсе могут возникать при изменении фокуса или при вызове, выборе или изменении состояния или свойства элемента пользовательского интерфейса.

AccEvent устанавливается с пакетом SDK для Windows. Он находится в папке \bin\<version>\<platform> пути установки пакета SDK (Accevent.exe).

Примечание.

AccEvent — это устаревшее средство. Вместо этого рекомендуется использовать аналитики специальных возможностей.

Требования

AccEvent можно использовать для проверки данных специальных возможностей в системах, которые не имеют автоматизации пользовательского интерфейса, изначально она была написана для Microsoft Active Accessibility. Для проверки автоматизации пользовательского интерфейса в системе должна присутствовать служба автоматизации пользовательского интерфейса. Дополнительные сведения см. в разделе "Требования" автоматизации пользовательского интерфейса.

AccEvent устанавливается как часть общего набора средств в пакете SDK для Windows, он не распространяется как отдельная загрузка exe. Пакет SDK для Windows включает все средства, связанные с специальными возможностями, описанные в этом разделе. Получите пакет SDK для Windows. (На этой странице также есть архив загрузки пакета SDK, связанный с этой страницей, если вам нужна предыдущая версия.)

Чтобы запустить AccEvent, найдите AccEvent.exe в папке \bin\<version>\<platform> и запустите ее (обычно не требуется запускать от имени администратора).

Окно наблюдателя за событиями со специальными возможностями

При запуске AccEvent отображается главное окно. В главном окне AccEvent отображаются события автоматизации пользовательского интерфейса или microsoft Active Специальные возможности, создаваемые приложениями, выполняющимися. Основное окно состоит из следующих основных частей:

  • Строка заголовка. Отображает текущий режим работы и состояние.
  • Строка меню. Предоставляет доступ к функциональным возможностям AccEvent .
  • Представление данных. Отображает сведения о каждом событии, включая идентификатор события и выбранные свойства элемента пользовательского интерфейса, вызвавшее событие.

AccEvent имеет только графический пользовательский интерфейс; Для этого средства нет аргументов командной строки, но вы можете использовать другие средства для обработки выходного журнала в виде текста.

На следующем рисунке показано главное окно AccEvent .

пользовательский интерфейс для средства наблюдателя за событиями со специальными возможностями

Задачи наблюдателя за событиями со специальными возможностями

В этом разделе содержатся сведения о часто используемых задачах AccEvent .

Настройка режима работы

Вы используете меню "Режим " для настройки режима работы AccEvent и выбора параметров, которые управляют поведением средства. Вы можете выбрать следующие параметры.

При выборе этого параметра AccEvent делает это
Всегда поверх Отображается поверх любого другого пользовательского интерфейса на экране.
События UIA Отображает сведения о событиях автоматизации пользовательского интерфейса.
WinEvents (в контексте) Отображает сведения о событиях Microsoft Active Accessibility (WinEvents), передаваемых в функции перехватчика, которые находятся в адресном пространстве сервера. Дополнительные сведения см. в разделе In-Context Функции перехватчика.
WinEvents (вне контекста) Отображает сведения о событиях Microsoft Active Accessibility (WinEvents), передаваемых в функции перехватчика, которые находятся в адресном пространстве клиента. Дополнительные сведения см. в разделе "Функции перехватчика вне контекста".
Показать прямоугольник выделения Выделяет прямоугольник вокруг элемента пользовательского интерфейса, вызвавшее выбранное событие.
Отображение подсказки сведений Отображает сведения о событии в подсказке.
Настройки Отображает диалоговое окно "Параметры событий UIA " или "Параметры WinEvent ".

 

Фильтрация событий автоматизации пользовательского интерфейса

Чтобы настроить события и свойства службы автоматизации пользовательского интерфейса, отображаемые в окне AccEvent , выберите меню "Режим ", выберите события UIA и выберите "Параметры". Откроется диалоговое окно "Параметры событий UIA ". Это диалоговое окно также можно использовать для фильтрации событий.

Диалоговое окно "Параметры событий UIA " содержит следующие области:

  • Глобальные события

    Установите флажок FocusChangedEvent , чтобы отобразить сведения о глобальных событиях изменения фокуса.

  • Тип события

    Выберите интересующие вас события.

  • Объем

    Выберите элемент пользовательского интерфейса, который требуется , чтобы AccEvent прослушивал события.

  • Включение событий из

    Выберите непосредственные дочерние элементы , если вы хотите просмотреть события из непосредственных дочерних элементов элемента пользовательского интерфейса, выбранного на панели "Область ". Если вы хотите увидеть события из всех потомков, выберите "Все потомки".

  • Свойства отчета

    Выберите свойства, отображаемые после каждого события в главном окне. Если в меню "Режим" выбрана подсказка "Показать сведения", выбранные свойства также отображаются в подсказке.

Фильтрация активных событий специальных возможностей

Чтобы настроить события и свойства Microsoft Active Accessibility, отображаемые в окне AccEvent , щелкните меню "Режим ", выберите WinEvents (в контексте) или WinEvents (вне контекста) и выберите пункт "Параметры". Откроется диалоговое окно "Параметры WinEvent ". Это диалоговое окно также можно использовать для фильтрации событий.

Диалоговое окно "Параметры WinEvent" содержит следующие области:

  • объекты

    Выберите объекты, к которым нужно прослушивать события AccEvent . AccEvent может прослушивать события, исходящие из окон, из курсора или из курсора. Окно выбрано по умолчанию.

  • События

    Выберите интересующие вас события. Все события отображаются по умолчанию.

  • Сведения о событии

    Выберите нужные сведения после имени каждого события в главном окне.

  • Свойства объекта

    Выберите свойства, отображаемые после каждого события в главном окне. Если в меню "Режим" выбрана подсказка "Показать сведения", выбранные свойства также отображаются в подсказке. По умолчанию выбраны имя, роль и состояние .

  • Фильтрация

    Выберите одну из переключателей в разделе фильтрации, чтобы отфильтровать события, вызванные окнами, указанными в поле hWNDs . Переключатель не фильтруется по умолчанию.

    • Нажмите переключатель "Исключить ", чтобы отобразить только события, возникающие из объектов, отличных от указанных окон.
    • Выберите переключатель "Включить только " и укажите один или несколько дескрипторов окна, чтобы отобразить только события, вызванные этими окнами.
    • Установите флажок "Потомки ", чтобы включить события, вызванные потомками указанных окон.

  • Параметры

    Выберите любой из следующих параметров:

    При выборе этого параметра AccEvent делает это
    Использование invoke Использует IDispatch::Invoke для получения свойств объекта вместо использования методов IAccessible .
    Всегда получать объект (даже если свойства объекта не выбраны) Извлекает объект, связанный с событием, даже если элементы не выбраны в области свойств объекта.
    Отображение свойства по умолчанию (в дополнение к выбранным свойствам) Отображает свойство по умолчанию, если таковой есть, для объекта, связанного с событием, а также элементы, выбранные в области свойств объекта.
    Отображение сведений о событиях из невидимых и скрытых окон Отображает выбранные элементы из области сведений о событиях для всех объектов, включая элементы в невидимых или скрытых окнах.
    Отображение полных сведений о событиях из невидимых и скрытых окон Отображает выбранные элементы из области сведений о событиях и выбранные (или по умолчанию) элементы из области свойств объекта для всех объектов, включая невидимые или скрытые окна.
    DebugBreak при следующем событии Вызывает исключение точки останова в процессе, который возникает в следующем WinEvent. Это сигнализирует отладчику об обработке исключения.

Использование меню событий

Используйте меню событий для выполнения следующих задач:

При выборе этого параметра AccEvent делает это
Начать прослушивание Начинает отображать сведения о событии в представлении данных.
Остановка прослушивания Останавливает отображение сведений о событии в представлении данных.
Очистка журнала событий Очищает содержимое представления данных.
Выбор всех событий Выбирает все события, перечисленные в представлении данных.
Копирование выбранных событий Копирует выбранные события в буфер обмена.

Сохранение активных событий специальных возможностей

Чтобы начать сохранение событий в текстовый файл, откройте меню "Файл " и нажмите кнопку "Начать ведение журнала в файл". AccEvent начинает записывать события в указанный файл, пока не выберите "Остановить ведение журнала " в меню "Файл ". Текстовый файл может быть полезен для устранения неполадок и просмотра событий позже.