Tipo de control AppBar

  • Artículo

En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario con el tipo de control AppBar.

Una barra de aplicaciones es un elemento de interfaz de usuario que presenta la navegación, los comandos y las herramientas al usuario. Para las aplicaciones de la Tienda Windows, las barras de aplicaciones para las aplicaciones se pueden mostrar presionando Tecla de Windows + Z.

En las secciones siguientes se definen la estructura de árbol Automatización de la interfaz de usuario necesaria, las propiedades, los patrones de control y los eventos para el tipo de control AppBar.

En este tema se incluyen las siguientes secciones.

Estructura de árbol típica

En la tabla siguiente se muestra un control típico y una vista de contenido del árbol de Automatización de la interfaz de usuario que pertenece a los controles AppBar y se describe lo que se puede contener en cada vista. Button es el elemento más común dentro de una barra de aplicaciones, pero también son posibles otros controles que invocan acciones para una aplicación. Una barra de aplicaciones también puede tener 0 o más separadores (tipo de control Separador ), que aparecen en la vista de control tal como se colocan entre los otros controles. Para más información sobre el árbol de UI Automation, vea Información general del árbol de UI Automation.

Vista de control Vista de contenido
  • AppBar
    • Botón (0 o muchos)
    • Otros controles (0 o varios)
  • No aplicable
    • Botón (0 o muchos)
    • Otros controles (0 o varios)

 

Propiedades pertinentes

En la tabla siguiente se enumeran las propiedades Automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para los controles que implementan el tipo de control AppBar. Para obtener más información sobre las propiedades de Automatización de la interfaz de usuario, vea Recuperar propiedades de Automatización de la interfaz de usuario Elements.

Propiedad de automatización de interfaz de usuario Valor Notas
UIA_AutomationIdPropertyId Vea las notas. El valor de esta propiedad debe ser único entre todos los elementos del mismo nivel en la vista sin procesar del árbol de Automatización de la interfaz de usuario.
UIA_BoundingRectanglePropertyId Vea las notas. El valor que expone esta propiedad debe incluir todos los controles que se contienen dentro de ella.
UIA_ControlTypePropertyId AppBar
UIA_IsContentElementPropertyId FALSE Un control de barra de aplicación no se incluye en la vista de contenido del árbol de Automatización de la interfaz de usuario.
UIA_IsControlElementPropertyId TRUE Un control de barra de aplicaciones siempre se incluye en la vista de control del árbol de Automatización de la interfaz de usuario.
UIA_IsKeyboardFocusablePropertyId Vea las notas Si el control puede recibir el foco del teclado, debe admitir esta propiedad. Los controles dentro de la barra de aplicaciones normalmente pueden tomar el foco del teclado.
UIA_IsOffscreenPropertyId Vea las notas. El valor de esta propiedad depende de si el control es visible en la pantalla.
UIA_LabeledByPropertyId Null Normalmente, los controles de la barra de aplicaciones no tienen una etiqueta.
UIA_LocalizedControlTypePropertyId Vea las notas. Cadena localizada correspondiente al tipo de control AppBar . El valor predeterminado es "app bar" para en-US o inglés (Estados Unidos).
UIA_NamePropertyId Vea las notas. El control de barra de aplicaciones no necesita un nombre a menos que una aplicación tenga más de una barra de aplicaciones. Si hay más de una barra de aplicaciones en una aplicación, use esta propiedad para exponer nombres distintivos, como "Top" o "Bottom".

 

Eventos necesarios

En la tabla siguiente se enumeran los eventos de Automatización de la interfaz de usuario que los controles de barra de aplicaciones son necesarios para admitir. Para más información sobre los eventos, vea UI Automation Events Overview.

Evento de Automatización de la interfaz de usuario Notas
UIA_AutomationFocusChangedEventId
UIA_BoundingRectanglePropertyId evento de cambio de propiedad.
UIA_IsEnabledPropertyId evento de cambio de propiedad. Si el control admite la propiedad IsEnabled , debe admitir este evento.
UIA_IsOffscreenPropertyId evento de cambio de propiedad. Si el control admite la propiedad IsOffscreen , debe admitir este evento.
UIA_StructureChangedEventId

 

Eventos relevantes

En la tabla siguiente se enumeran los eventos de Automatización de la interfaz de usuario que son especialmente relevantes para los controles que implementan el tipo de control AppBar, pero que no son estrictamente necesarios.

Evento de Automatización de la interfaz de usuario Notas
UIA_MenuClosedEventId Las implementaciones de la plataforma pueden desencadenar este evento cuando se cierra el control de barra de aplicaciones.
UIA_MenuOpenedEventId Las implementaciones de la plataforma pueden desencadenar este evento cuando se abre el control de barra de aplicaciones.
IUIAutomationPropertyChangedEventHandler Controlador de eventos cambiado por propiedades.

 

Conceptual

Información general sobre tipos de control de UI Automation

Información general sobre UI Automation

Referencia

Control XAML appBar

Objeto WinJS.UI.AppBar