Tipo de control StatusBar

  • 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 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 relativa a esa operación del objeto en la aplicación.

En las secciones siguientes se definen la estructura de árbol Automatización de la interfaz de usuario requerida, las propiedades, los patrones de control y los eventos para el 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 marco de interfaz de usuario integra Automatización de la interfaz de usuario compatibilidad con los tipos de control y los patrones de control.

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 de barra de estado y se describe lo que se puede contener en cada vista. 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
  • StatusBar
    • Edición (0 o más)
    • ProgressBar (0 o muchos)
    • Imagen (0 o muchos)
    • Botón (0 o muchos)
  • StatusBar
    • Edición (0 o más)
    • ProgressBar (0 o muchos)
    • Imagen (0 o muchos)
    • Botón (0 o muchos)

 

Propiedades relevantes

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 de la barra de estado. 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 rectángulo delimitador de una barra de estado debe abarcar todos los controles que incluye.
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
UIA_IsContentElementPropertyId TRUE El control de barra de estado siempre se incluye en la vista de contenido del árbol de Automatización de la interfaz de usuario.
UIA_IsControlElementPropertyId TRUE El control de 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 NULL Normalmente, el control de 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 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 Automatización de la interfaz de usuario necesarios para ser compatibles con los controles de barra de estado. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.

Patrón de control Soporte técnico Notas
IGridProvider Opcional Los controles de barra de estado deben admitir el patrón de control Grid para que se puedan supervisar y hacer referencia fácilmente a partes individuales para obtener información.

 

Eventos necesarios

En la tabla siguiente se enumeran los eventos Automatización de la interfaz de usuario que los controles de barra de estado 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

 

Comentarios

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

Información general sobre tipos de control de UI Automation

Información general sobre UI Automation