Compartir a través de

Herramientas de accesibilidad: AccEvent (Monitor de eventos accesibles)

AccEvent (Monitor de eventos accesibles) permite a los desarrolladores y evaluadores validar que los elementos de la interfaz de usuario de una aplicación generan eventos adecuados de Automatización de la interfaz de usuario de Microsoft y Accesibilidad activa de Microsoft cuando se producen cambios en la interfaz de usuario. Los cambios en la interfaz de usuario pueden producirse cuando cambia el foco o cuando se invoca, selecciona o tiene un cambio de estado o propiedad.

AccEvent se instala con el Kit de desarrollo de software (SDK) de Windows. Se encuentra en la carpeta \bin\<version>\<platform> de la ruta de instalación del SDK (Accevent.exe).

Nota:

AccEvent es una herramienta heredada. Se recomienda usar Accessibility Insights.

Requisitos

AccEvent se puede usar para examinar los datos de accesibilidad en sistemas que no tienen automatización de la interfaz de usuario, originalmente se escribió para accesibilidad activa de Microsoft. Para examinar la automatización de la interfaz de usuario, la automatización de la interfaz de usuario debe estar presente en el sistema. Para obtener más información, consulte la sección "Requisitos" de automatización de la interfaz de usuario.

AccEvent se instala como parte del conjunto general de herramientas en Windows SDK, no se distribuye como una descarga exe independiente. Windows SDK incluye todas las herramientas relacionadas con la accesibilidad documentadas en esta sección. Obtenga windows SDK. (También hay un archivo de descarga del SDK vinculado desde esa página, si necesita una versión anterior).

Para ejecutar AccEvent, busque AccEvent.exe en la carpeta \bin\<version>\<platform> y ejecútelo (normalmente no tiene que ejecutarse como administrador).

Ventana Del monitor de eventos accesible

Al iniciar AccEvent, se muestra la ventana principal. La ventana principal accEvent muestra los eventos de automatización de la interfaz de usuario o accesibilidad activa de Microsoft generados por las aplicaciones que se ejecutan. La ventana principal tiene las siguientes partes principales:

  • Barra de título. Muestra el estado y el modo operativo actuales.
  • Barra de menús. Proporciona acceso a la funcionalidad accEvent .
  • Vista de datos. Muestra información sobre cada evento, incluido el identificador de evento y las propiedades seleccionadas del elemento de interfaz de usuario que generó el evento.

AccEvent solo tiene una interfaz gráfica de usuario; no hay argumentos de línea de comandos para esta herramienta, pero puede usar otras herramientas para procesar el registro de salida como texto.

En la imagen siguiente se muestra la ventana principal de AccEvent .

la interfaz de usuario de la herramienta de monitor de eventos accesible

Tareas accesibles del monitor de eventos

En esta sección se incluye información sobre las tareas de AccEvent más usadas.

Configuración del modo de funcionamiento

Use el menú Modo para configurar el modo operativo AccEvent y seleccione los valores que controlan el comportamiento de la herramienta. Puede seleccionar las siguientes opciones.

Cuando se selecciona esta opción AccEvent hace esto
Siempre en Primer Plano Aparece encima de cualquier otra interfaz de usuario en la pantalla.
Eventos de UIA Muestra información sobre los eventos de Automatización de la interfaz de usuario.
WinEvents (en contexto) Muestra información sobre los eventos de accesibilidad activa de Microsoft (WinEvents) pasados a funciones de enlace que residen en el espacio de direcciones del servidor. Para obtener más información, consulte In-Context Funciones de enlace.
WinEvents (fuera del contexto) Muestra información sobre los eventos de accesibilidad activa de Microsoft (WinEvents) pasados a funciones de enlace que residen en el espacio de direcciones del cliente. Para obtener más información, vea Funciones de enlace fuera de contexto.
Mostrar rectángulo resaltado Resalta un rectángulo alrededor del elemento de interfaz de usuario que generó el evento seleccionado.
Mostrar información sobre herramientas de información Muestra información de eventos en una información sobre herramientas.
Configuración Muestra el cuadro de diálogo Configuración de eventos UIA o Configuración de WinEvent .

 

Filtrado de eventos de automatización de la interfaz de usuario

Para configurar los eventos y propiedades de Automatización de la interfaz de usuario que se muestran en la ventana AccEvent , haga clic en el menú Modo , seleccione Eventos UIA y, a continuación, seleccione Configuración. Se muestra el cuadro de diálogo Configuración del evento UIA . También puede usar este cuadro de diálogo para filtrar los eventos.

El cuadro de diálogo Configuración de eventos UIA contiene los siguientes paneles:

  • Eventos globales

    Active la casilla FocusChangedEvent para mostrar información sobre los eventos modificados por el foco global.

  • tipo de evento

    Seleccione los eventos que le interesen.

  • Ámbito

    Seleccione el elemento de interfaz de usuario al que desea que AccEvent escuche eventos.

  • Incluir eventos de

    Seleccione Elementos secundarios inmediatos si desea ver eventos de los elementos secundarios inmediatos del elemento de interfaz de usuario seleccionado en el panel Ámbito . Si desea ver eventos de todos los elementos descendientes, seleccione Todos los descendientes.

  • Propiedades del informe

    Seleccione las propiedades que desea mostrar después de cada evento en la ventana principal. Si se selecciona Mostrar información sobre herramientas de información en el menú Modo , las propiedades seleccionadas también se muestran en una información sobre herramientas.

Filtrado de eventos de accesibilidad activa

Para configurar los eventos y propiedades de accesibilidad activa de Microsoft que se muestran en la ventana AccEvent , haga clic en el menú Modo , seleccione WinEvents (en contexto) o WinEvents (fuera de contexto) y, a continuación, seleccione Configuración. Se muestra el cuadro de diálogo Configuración de WinEvent . También puede usar este cuadro de diálogo para filtrar los eventos.

El cuadro de diálogo Configuración de WinEvent contiene los siguientes paneles:

  • objetos de

    Seleccione los objetos a los que desea que AccEvent escuche eventos. AccEvent puede escuchar eventos que se originan en ventanas, desde el cursor o desde el símbolo de intercalación. La ventana está seleccionada de forma predeterminada.

  • Eventos

    Seleccione los eventos que le interesen. Todos los eventos se muestran de forma predeterminada.

  • Información del evento

    Seleccione la información que desea mostrar después del nombre de cada evento en la ventana principal.

  • Propiedades del objeto

    Seleccione las propiedades que desea mostrar después de cada evento en la ventana principal. Si se selecciona Mostrar información sobre herramientas de información en el menú Modo , las propiedades seleccionadas también se muestran en una información sobre herramientas. El nombre, el rol y el estado se seleccionan de forma predeterminada.

  • Filtering

    Seleccione uno de los botones de radio de la sección de filtrado para filtrar los eventos generados por las ventanas especificadas en el campo hWNDs . El botón de radio No filtrar está seleccionado de forma predeterminada.

    • Seleccione el botón de radio Excluir para mostrar solo los eventos generados desde objetos distintos de las ventanas especificadas.
    • Seleccione el botón de radio Incluir solo y especifique uno o varios identificadores de ventana para mostrar solo los eventos generados desde esas ventanas.
    • Active la casilla y Descendientes para incluir eventos generados por los descendientes de las ventanas especificadas.

  • Opciones

    Seleccione cualquiera de las opciones siguientes:

    Cuando se selecciona esta opción AccEvent hace esto
    Uso de Invoke Usa IDispatch::Invoke para recuperar propiedades de objeto en lugar de usar métodos IAccessible .
    Obtener siempre el objeto (incluso si no hay ninguna propiedad de objeto seleccionada) Recupera el objeto asociado al evento incluso si no se selecciona ningún elemento en el panel Propiedades del objeto.
    Mostrar la propiedad predeterminada (además de las propiedades seleccionadas) Muestra la propiedad predeterminada, si existe, para el objeto asociado al evento, junto con los elementos seleccionados en el panel Propiedades del objeto.
    Mostrar información de eventos de ventanas invisibles u ocultas Muestra los elementos seleccionados del panel Información de eventos para todos los objetos, incluidos los de ventanas invisibles u ocultas.
    Mostrar información completa de eventos de ventanas invisibles u ocultas Muestra los elementos seleccionados en el panel Información de eventos y los elementos seleccionados (o predeterminados) del panel Propiedades del objeto, para todos los objetos, incluidos los de ventanas invisibles u ocultas.
    DebugBreak en el siguiente evento Hace que se produzca una excepción de punto de interrupción en el proceso que origina el siguiente WinEvent. Esto indica al depurador que controle la excepción.

Usar el menú Evento

Use el menú Evento para realizar las tareas siguientes:

Cuando se selecciona esta opción AccEvent hace esto
Iniciar escucha Comienza a mostrar información de eventos en la vista Datos.
Detener la escucha Deja de mostrar información de eventos en la vista Datos.
Borrar historial de eventos Borra el contenido de la vista Datos.
Seleccionar todos los eventos Selecciona todos los eventos enumerados en la vista Datos.
Copiar eventos seleccionados Copia los eventos seleccionados en el Portapapeles.

Guardar eventos de accesibilidad activa

Para empezar a guardar eventos en un archivo de texto, abra el menú Archivo y seleccione Iniciar registro en archivo. AccEvent comienza a escribir eventos en el archivo especificado hasta que seleccione Detener registro en el menú Archivo . El archivo de texto puede ser útil para solucionar problemas y revisar los eventos más adelante.