Compartir a través de

Tipo de control text

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 Text.

Un control de texto es un elemento de interfaz de usuario básico que representa un fragmento de texto en la pantalla.

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 text . Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de árbol en los que el marco o la plataforma de la interfaz de usuario integra la compatibilidad de ui Automation con los tipos de control y los patrones de control.

Este tema contiene las secciones siguientes.

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 texto 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
  • Mensaje de texto
  • Texto (si el contenido)

 

Un control de texto se puede usar solo como etiqueta o como texto estático en un formulario. También se puede contener dentro de la estructura de uno de los siguientes elementos:

  • DataItem
  • ListItem
  • TreeItem

Es posible que los controles de texto no aparezcan en la vista de contenido del árbol de automatización de la interfaz de usuario porque el texto se muestra a menudo a través de la propiedad Name de otro control. Por ejemplo, el texto usado para etiquetar un control de cuadro combinado se expone a través de la propiedad Name del control. Dado que el control de cuadro combinado está en la vista de contenido del árbol de automatización de la interfaz de usuario, el control de texto no debe estar ahí. Los controles de texto pueden tener elementos secundarios en la vista de contenido si hay un objeto incrustado como un hipervínculo.

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 los controles de texto. 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. 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 text
UIA_IsContentElementPropertyId Depende El control de texto es contenido si contiene información no expuesta en la propiedad Name de otro control.
UIA_IsControlElementPropertyId VERDADERO El control de texto siempre debe ser un control .
UIA_IsKeyboardFocusablePropertyId Vea las notas. Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
UIA_LabeledByPropertyId NULO Los controles de texto no tienen una etiqueta de texto estático.
UIA_LocalizedControlTypePropertyId Vea las notas. Cadena localizada correspondiente al tipo de control text . El valor predeterminado es "text" para en-US o inglés (Estados Unidos).
UIA_NamePropertyId Vea las notas. El nombre de un control de texto puede ser el texto que muestra. Sin embargo, si el control también admite el patrón text de y el texto es extenso, no use el contenido de texto completo como valor nombre de. En su lugar, proporcione un Nombre valor más corto derivado de otras propiedades del control.

 

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 texto. 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
IGridItemProvider Depende Si el control de texto está incluido en un control de tabla, se debe admitir el patrón de control GridItem.
ITableItemProvider Depende Si el control de texto está incluido en un control de tabla, se debe admitir el patrón de control tableItem.
ITextProvider Depende El texto debe admitir el patrón de control text para mejorar la accesibilidad; sin embargo, 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).
IValueProvider Nunca Un control de texto nunca admite el patrón de control de Value. Si el texto es editable, es el Tipo de control Editar.

 

Eventos necesarios

En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario que se necesitan controles de texto 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_StructureChangedEventId
UIA_Text_TextChangedEventId Si el control admite el patrón de control Text, debe admitir este evento.

 

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

 

 

  • Last updated on