Tipo de control ToolTip

  • 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 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

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
  • Información sobre herramientas
    • Text (0 o más)
    • Imagen (0 o más)
  • Información sobre herramientas

 

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.

 

Conceptual

Información general sobre tipos de control de UI Automation

Información general sobre UI Automation