Tipo de control ToolTip
En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario con el tipo de control Información sobre herramientas. Los controles de información sobre herramientas son ventanas emergentes que contienen texto.
En las secciones siguientes se definen la estructura de árbol 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 plataforma de la 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
- 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 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 |
|---|---|
|
|
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 el UIA_ToolTipOpenedEventId para asegurarse de que obtienen de forma coherente información contenida en la información sobre herramientas.
Propiedades relevantes
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 ToolTip. 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 exterior que contiene el control completo. |
| UIA_ClickablePointPropertyId | Vea las notas. | El punto 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 | ToolTip | |
| 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 | True | 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 | NULL | Los controles de información sobre herramientas siempre se etiquetan automáticamente por su contenido. |
| UIA_LocalizedControlTypePropertyId | Vea las notas. | Cadena localizada que corresponde 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 en la información sobre herramientas. |
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 información sobre herramientas. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.
| Patrón de control | Soporte técnico | Notas |
|---|---|---|
| ITextProvider | Depende | Para mejorar la accesibilidad, un control de información sobre herramientas puede admitir el patrón de control Texto , 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 Ventana para que puedan cerrarse automáticamente. |
Eventos necesarios
Los controles de información sobre herramientas deben generar el evento UIA_ToolTipOpenedEventId cuando aparezcan 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 Automatización de la interfaz de usuario que los controles de información sobre herramientas 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_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 Window , debe admitir este evento. |
| UIA_Window_WindowOpenedEventId | Si el control admite el patrón de control Window , debe admitir este evento. |
| UIA_WindowWindowVisualStatePropertyId evento de cambio de propiedad. | Si el control admite el patrón de control Window , debe admitir este evento. |
Temas relacionados
-
Conceptual