Tipo de control ToolTip
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 información sobre herramientas de. Los controles de información sobre herramientas son ventanas emergentes que contienen texto.
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 para el tipo de control ToolTip. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de información sobre herramientas en los que el marco o la plataforma de la interfaz de usuario integra la compatibilidad con 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
- de propiedades pertinentes
- 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 información sobre herramientas y 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 |
|---|---|
|
|
Los controles de información sobre herramientas solo aparecen en la vista de contenido del árbol de automatización de la interfaz de usuario si pueden recibir el foco del teclado. De lo contrario, toda la información de la información sobre herramientas está disponible en la propiedad IUIAutomationElement::CurrentHelpText (o CachedHelpText) en el elemento al que hace referencia la información sobre herramientas.
La información sobre herramientas debe aparecer debajo del control al que hace referencia su información. Los clientes deben escuchar la UIA_ToolTipOpenedEventId para asegurarse de que obtienen información de forma coherente contenida en la información sobre herramientas.
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 el tipo de control información sobre herramientas de. 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. | Rectángulo más externo que contiene todo el control. |
| UIA_ClickablePointPropertyId | Vea las notas. | El punto en el que se puede hacer clic debe ser la parte de la información sobre herramientas que descarta el control. Algunas informaciones sobre herramientas no tienen esta capacidad y no tendrán un punto en el que se pueda hacer clic. |
| UIA_ControlTypePropertyId | de información sobre herramientas | |
| UIA_IsContentElementPropertyId | Depende | Si el control de información sobre herramientas puede recibir el foco del teclado, debe aparecer en la vista de contenido del árbol. Si solo es texto, está disponible como la propiedad IUIAutomationElement::CurrentHelpText (o CachedHelpText) del control que lo generó. |
| UIA_IsControlElementPropertyId | Verdadero | El control de información sobre herramientas 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. |
| UIA_LabeledByPropertyId | NULO | Los controles de información sobre herramientas siempre se etiquetan automáticamente por su contenido. |
| UIA_LocalizedControlTypePropertyId | Vea las notas. | Cadena localizada correspondiente al tipo de control ToolTip. El valor predeterminado es "información sobre herramientas" para en-US o inglés (Estados Unidos). |
| UIA_NamePropertyId | Vea las notas. | El nombre del control de información sobre herramientas es el texto que se muestra dentro de la información sobre herramientas. |
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 información sobre herramientas. 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 |
|---|---|---|
| ITextProvider | Depende | Para mejorar la accesibilidad, un control de información sobre herramientas puede admitir el patrón de control Text, aunque no es necesario. El patrón de control Text es útil cuando el texto tiene atributos y estilo enriquecidos (por ejemplo, color, negrita y cursiva). |
| IWindowProvider | Depende | La información sobre herramientas que se puede cerrar haciendo clic en un elemento de interfaz de usuario debe admitir el patrón de control de Ventana para que puedan cerrarse automáticamente. |
Eventos necesarios
Los controles de información sobre herramientas deben generar el evento UIA_ToolTipOpenedEventId cuando aparecen en la pantalla. El evento incluirá una referencia al elemento automatización de la interfaz de usuario de la propia información sobre herramientas.
En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario que se requieren controles de información sobre herramientas 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 propiedadIsEnabled, debe admitir este evento. |
| UIA_IsOffscreenPropertyId evento de cambio de propiedad. | Si el control admite la propiedad IsOffscreen, debe admitir este evento. |
| UIA_NamePropertyId evento de cambio de propiedad. | |
| UIA_Text_TextChangedEventId | Si el control admite el patrón de control Text, debe admitir este evento. |
| UIA_ToolTipClosedEventId | |
| UIA_ToolTipOpenedEventId | |
| UIA_StructureChangedEventId | |
| UIA_Window_WindowClosedEventId | Si el control admite el patrón de control Ventana, debe admitir este evento. |
| UIA_Window_WindowOpenedEventId | Si el control admite el patrón de control Ventana, debe admitir este evento. |
| UIA_WindowWindowVisualStatePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Ventana, debe admitir este evento. |
Temas relacionados
-
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