Tipo de control TitleBar
En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario con el tipo de control TitleBar. Un control de barra de título representa un título o una barra de subtítulo en una ventana.
En las secciones siguientes se definen las Automatización de la interfaz de usuario estructura de árbol, propiedades, patrones de control y eventos necesarios para el tipo de control TitleBar. Los requisitos de Automatización de la interfaz de usuario se aplican a todos los controles de barra de título en los que el marco de interfaz de usuario o la plataforma se 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
- 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 título 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 |
|---|---|
|
(No aplicable; el control de barra de título no tiene 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 el tipo de control TitleBar. 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_ClickablePointPropertyId | Vea las notas. | Se admite si hay un rectángulo delimitador. Si no se puede hacer clic en todos los puntos del rectángulo delimitador, y el elemento realiza pruebas de posicionamiento especializadas, invalida y proporciona un punto en el que se puede hacer clic. |
| UIA_ControlTypePropertyId | TitleBar | Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario. |
| UIA_IsContentElementPropertyId | FALSE | El control de barra de título nunca 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 título siempre se incluye en la vista de control del árbol de Automatización de la interfaz de usuario. |
| UIA_IsKeyboardFocusablePropertyId | FALSE | Un control de barra de título nunca tiene el foco del teclado. |
| UIA_IsOffscreenPropertyId | Depende | Un control de barra de título devuelve un valor en función de si está visible en la pantalla. |
| UIA_LabeledByPropertyId | Vea las notas. | Normalmente, un control de barra de título no tiene una etiqueta. |
| UIA_LocalizedControlTypePropertyId | Vea las notas. | Cadena localizada que corresponde al tipo de control TitleBar. El valor predeterminado es "barra de título" para en-US o inglés (Estados Unidos). |
| UIA_NamePropertyId | "" | Una barra de título no es contenido; su información textual se expone por el nombre de la ventana primaria. |
Patrones de control necesarios
El tipo de control TitleBar no es necesario para admitir ningún patrón de control. Su funcionalidad se expone a través del patrón de control Window en el tipo de control Window .
Eventos necesarios
En la tabla siguiente se enumeran los eventos Automatización de la interfaz de usuario que los controles de barra de título 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 |
Temas relacionados
-
Conceptual