Tipo de control text

En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario 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 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 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 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 texto 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
  • Texto
  • Texto (si hay contenido)

 

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

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 allí. Los controles de texto pueden tener elementos secundarios en la vista de contenido si hay un objeto incrustado, como un hipervínculo.

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 los controles de texto. 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. 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 Texto
UIA_IsContentElementPropertyId Depende El control de texto es contenido si contiene información no expuesta en la propiedad Name de otro control.
UIA_IsControlElementPropertyId TRUE 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 NULL 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 y el texto es extenso, no use el contenido de texto completo como valor Name . En su lugar, proporcione un valor Name que sea más corto, derivado de otras propiedades del control.

 

Patrones de control necesarios

En la tabla siguiente se muestran los patrones de control de automatización de la interfaz de usuario que se deben admitir por los controles de texto. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.

Patrón de control Soporte técnico 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 Texto 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 Value . Si el texto es editable, es el tipo de control Editar .

 

Eventos necesarios

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

 

Conceptual

Información general sobre tipos de control de UI Automation

Información general sobre UI Automation