Compartir a través de

Compatibilidad de UI Automation para el tipo de control Edit

Nota:

Esta documentación está pensada para desarrolladores de .NET Framework que desean usar las clases de automatización de la interfaz de usuario administradas definidas en el espacio de nombres System.Windows.Automation. Para obtener la información más reciente sobre la automatización de la interfaz de usuario, consulte API de Windows Automation: Automatización de la interfaz de usuario.

En este tema se proporciona información sobre la compatibilidad de automatización de la interfaz de usuario con el tipo de control Edit. En UI Automation, un tipo de control es un conjunto de condiciones que un control debe cumplir para poder usar la propiedad ControlTypeProperty. Las condiciones incluyen directrices específicas para la estructura del árbol de automatización de la interfaz de usuario, los valores de las propiedades de automatización de la interfaz de usuario y los patrones de control.

Los controles de edición permiten a un usuario ver y editar una línea de texto sencilla sin compatibilidad con formato enriquecido.

En las secciones siguientes se definen la estructura de árbol, las propiedades, los patrones de control y los eventos para el tipo de control de edición de UI Automation necesarios. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de edición, ya sea Windows Presentation Foundation (WPF), Win32 o Windows Forms.

Estructura de árbol de Automatización de la interfaz de usuario necesaria

En la tabla siguiente se muestra la vista de control y la vista de contenido del árbol de automatización de la interfaz de usuario que pertenece a los controles de edición y se 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
Editar Editar

Los controles que implementan el tipo de control Editar siempre tendrán cero barras de desplazamiento en la vista de control del árbol de automatización de la interfaz de usuario porque es un control de una sola línea. La única línea de texto puede encapsularse en algunos escenarios de diseño. El tipo de control Edit es más adecuado para mantener pequeñas cantidades de texto editable o seleccionable.

Propiedades de Automatización de la interfaz de usuario necesarias

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 editar controles. Para obtener más información sobre las propiedades de automatización de la interfaz de usuario, consulte Propiedades de automatización de la interfaz de usuario para clientes.

Propiedad de automatización de interfaz de usuario Importancia Notas
AutomationIdProperty Vea las notas. El valor de esta propiedad debe ser único en todos los controles de una aplicación.
BoundingRectangleProperty Vea las notas. El rectángulo exterior que contiene el control completo.
ClickablePointProperty Vea las notas. El control de edición debe tener un punto en el que se pueda hacer clic que proporcione el foco de entrada a la parte de edición del control cuando un usuario hace clic en el mouse allí.
IsKeyboardFocusableProperty Vea las notas. Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
NameProperty Vea las notas. El nombre del control de edición se genera normalmente a partir de una etiqueta de texto estático. Si no hay una etiqueta de texto estático, el desarrollador de la aplicación debe asignar un valor de propiedad para Name . La Name propiedad nunca debe contener el contenido textual del control de edición.
LabeledByProperty Vea las notas. Si hay una etiqueta de texto estática asociada al control, esta propiedad debe exponer una referencia a ese control. Si el control de texto es un subcomponente de otro control, no tendrá un LabeledBy conjunto de propiedades.
ControlTypeProperty Editar Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario.
LocalizedControlTypeProperty "edición" Cadena localizada que corresponde al tipo de control Edit.
IsContentElementProperty Cierto El control de edición siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario.
IsControlElementProperty Cierto El control de edición siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario.
IsPasswordProperty Vea las notas. Debe establecerse en true en los controles de edición que contienen contraseñas. Si un control de edición contiene contenido de contraseña, un lector de pantalla puede usar esta propiedad para determinar si las pulsaciones de tecla deben leerse como el usuario las escribe.

Propiedades y patrones de control de Automatización de la interfaz de usuario necesarios

En la tabla siguiente se enumeran los patrones de control necesarios para ser compatibles con todos los controles de edición. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.

Patrón de control/Propiedad del patrón de control Soporte técnico/valor Notas
ITextProvider Depende Los controles de edición deben admitir el patrón de control de texto, ya que la información de texto detallada siempre debe estar disponible para los clientes.
IValueProvider Depende Todos los controles de edición que toman una cadena deben exponer el patrón Value.
IsReadOnly Vea las notas. Esta propiedad debe establecerse para indicar si el control puede tener un valor establecido mediante programación o que el usuario pueda editarlo.
Value Vea las notas. Esta propiedad devolverá el contenido textual del control de edición. Si se configura IsPasswordProperty en true, esta propiedad debe generar un InvalidOperationException cuando se solicite.
IRangeValueProvider Depende Todos los controles de edición que toman un intervalo numérico deben exponer el patrón de control Range Value.
Minimum Vea las notas. Esta propiedad debe ser el valor más pequeño en el que se puede establecer el contenido del control de edición.
Maximum Vea las notas. Esta propiedad debe ser el valor más grande en el que se puede establecer el contenido del control de edición.
SmallChange Vea las notas. Esta propiedad debe indicar el número de posiciones decimales en las que se puede establecer el valor. Si la edición solo toma enteros, SmallChangeProperty debe ser 1. Si la edición toma un intervalo entre 1.0 y 2.0, el SmallChangeProperty valor debe ser 0.1. Si el control de edición toma un intervalo de 1,00 a 2,00, el SmallChangeProperty valor debe ser 0,001.
LargeChange Null Esta propiedad no necesita exponerse en un control de edición.
Value Vea las notas. Esta propiedad indicará el contenido numérico del control de edición. Cuando un cliente de Automatización de la interfaz de usuario establece un valor más preciso dentro de los intervalos especificados en las Minimum propiedades y Maximum , la propiedad Value se redondea automáticamente al valor aceptado más cercano.

Eventos de Automatización de la interfaz de usuario necesarios

En la siguiente tabla se enumeran los eventos de UI Automation necesarios para que sean compatibles con todos los controles de edición. Para obtener más información sobre los eventos, consulte UI Automation Events Overview.

Evento de Automatización de la interfaz de usuario Apoyo Notas
InvalidatedEvent Obligatorio Ninguno
TextSelectionChangedEvent Obligatorio Ninguno
TextChangedEvent Obligatorio Ninguno
Evento cambiado por propiedadBoundingRectangleProperty . Obligatorio Ninguno
Evento cambiado por propiedadIsOffscreenProperty . Obligatorio Ninguno
Evento cambiado por propiedadIsEnabledProperty . Obligatorio Ninguno
Evento cambiado por propiedadNameProperty . Obligatorio Ninguno
Evento cambiado por propiedadValueProperty . Depende Ninguno
Evento cambiado por propiedadHorizontallyScrollableProperty . Nunca Ninguno
Evento cambiado por propiedadHorizontalScrollPercentProperty . Nunca Ninguno
Evento cambiado por propiedadHorizontalViewSizeProperty . Nunca Ninguno
Evento cambiado por propiedadVerticalScrollPercentProperty . Nunca Ninguno
Evento cambiado por propiedadVerticallyScrollableProperty . Nunca Ninguno
Evento cambiado por propiedadVerticalViewSizeProperty . Nunca Ninguno
Evento cambiado por propiedadValueProperty . Depende Si el control admite el patrón de control de valores dentro del rango, debe admitir este evento.
AutomationFocusChangedEvent Obligatorio Ninguno
StructureChangedEvent Obligatorio Ninguno

Consulte también