Compartir a través de

Tipo de control StatusBar

  • Artículo

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

Un control de barra de estado muestra información sobre un objeto que se ve en una ventana de una aplicación, el componente del objeto o información contextual relacionada con la operación de ese objeto dentro de la aplicación.

En las secciones siguientes se define la estructura de árbol de automatización de la interfaz de usuario necesaria, las propiedades, los patrones de control y los eventos del tipo de control StatusBar. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de barra de estado en los que la plataforma o plataforma de la interfaz de usuario integra la compatibilidad de automatización de la interfaz de usuario para los tipos de control y los patrones de control.

Este tema contiene las secciones siguientes.

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 de barra de estado y se describe lo que se puede contener en cada vista. Para obtener más información sobre el árbol de automatización de la interfaz de usuario, consulte Introducción al árbol de automatización de la interfaz de usuario.

Vista de control Vista de contenido
  • StatusBar
    • Editar (0 o más)
    • ProgressBar (0 o varios)
    • Imagen (0 o varios)
    • Botón (0 o varios)
  • StatusBar
    • Editar (0 o más)
    • ProgressBar (0 o varios)
    • Imagen (0 o varios)
    • Botón (0 o varios)

 

Propiedades pertinentes

En la tabla siguiente se enumeran las propiedades de automatización de la interfaz de usuario cuyo valor o definición es especialmente relevante para los controles de la barra de estado. Para obtener más información sobre las propiedades de automatización de la interfaz de usuario, consulte Recuperar propiedades de elementos de automatización de la interfaz de usuario.

Ui Automation (propiedad) 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 rectángulo delimitador de una barra de estado debe abarcar todos los controles contenidos en él.
UIA_ClickablePointPropertyId Vea las notas. Se admite si hay un rectángulo delimitador. Si hay áreas dentro del rectángulo delimitador que no se pueden hacer clic y el elemento realiza pruebas de posicionamiento especializadas, invalide esto y proporcione un punto en el que se puede hacer clic.
UIA_ControlTypePropertyId statusBar de
UIA_IsContentElementPropertyId VERDADERO El control de la barra de estado siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario.
UIA_IsControlElementPropertyId VERDADERO El control de la barra de estado siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario.
UIA_IsKeyboardFocusablePropertyId Depende Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
UIA_IsOffscreenPropertyId Depende Si un control de barra de estado no está visible actualmente, devolverá TRUE para esta propiedad.
UIA_LabeledByPropertyId NULO Normalmente, el control de la barra de estado no tiene una etiqueta.
UIA_LocalizedControlTypePropertyId Vea las notas. Cadena localizada correspondiente al tipo de control StatusBar . El valor predeterminado es "barra de estado" para en-US o inglés (Estados Unidos).
UIA_NamePropertyId Vea las notas. El control de la barra de estado no necesita un nombre a menos que se use más de uno dentro de una aplicación. En este caso, distinga cada barra con nombres como "Estado de Internet" o "Estado de la aplicación".
UIA_OrientationPropertyId Depende Valor que indica la orientación del control: horizontal o vertical.

 

Patrones de control necesarios

En la tabla siguiente se enumeran los patrones de control de automatización de la interfaz de usuario necesarios para ser compatibles con los controles de barra de estado. Para obtener más información sobre los patrones de control, consulte Introducción a los patrones de control de automatización de la interfaz de usuario.

Patrón de control Apoyo Notas
IGridProvider Opcional Los controles de la barra de estado deben admitir el patrón de control grid para que se pueda supervisar y hacer referencia fácilmente a partes individuales para obtener información.

 

Eventos necesarios

En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario que los controles de barra de estado son necesarios para admitir. Para obtener más información sobre los eventos, consulte 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 de, debe admitir este evento.
UIA_StructureChangedEventId

 

Observaciones

Se recomienda que los controles de edición se usen como elementos de cuadrícula secundarios en una barra de estado. El uso de controles de edición facilita la asociación del propósito del campo de estado con su valor mediante el nombre del elemento y la propiedad value. Dado que los controles de texto no deben admitir el patrón de control Value, no deben usarse como elementos de cuadrícula secundarios.

conceptual de

Introducción a los tipos de control de automatización de la interfaz de usuario de

información general de automatización de la interfaz de usuario de