Tipo de control StatusBar
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
- Propiedades relevantes
- Patrones de control necesarios
- Eventos necesarios
- Comentarios:
- Temas relacionados
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 |
|---|---|
|
|
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.
Temas relacionados
-
Conceptual