Compartir a través de

Compatibilidad de UI Automation para el tipo de control ProgressBar

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 ProgressBar. 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, los patrones de control y los eventos de automatización de la interfaz de usuario.

Los controles de barra de progreso son un ejemplo de controles que implementan el tipo de control ProgressBar. Los controles de la barra de progreso se utilizan para señalar el avance de una operación prolongada. El control consta de un rectángulo que se rellena gradualmente con el color de resaltado del sistema a medida que avanza una operación.

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 ProgressBar. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de lista, 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 barra de progreso y se describe lo que se puede contener en cada vista. Para 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
Barra de progreso Barra de progreso

Los controles de barra de progreso no tienen elementos secundarios en la vistas de control o de contenido del árbol de UI Automation.

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 los controles de barra de progreso. Para 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: Propiedades 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. Se admite si hay un rectángulo delimitador. Si no todos los puntos que se encuentran dentro del rectángulo delimitador son seleccionables, y realiza pruebas de aciertos especializadas, invalide y ofrezca un punto en el que hacer clic.
IsKeyboardFocusableProperty Vea las notas. Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
NameProperty Vea las notas. El control de barra de progreso normalmente obtiene su nombre de una etiqueta de texto estático. Si no hay una etiqueta de texto estático, el desarrollador de la aplicación debe exponer un valor para la Name propiedad .
LabeledByProperty Vea las notas. Si hay una etiqueta de texto estático, esta propiedad debe exponer una referencia a ese control.
ControlTypeProperty Barra de progreso Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario.
LocalizedControlTypeProperty barra de progreso Cadena localizada que corresponde al tipo de control ProgressBar.
IsContentElementProperty Cierto El control de la barra de progreso siempre se incluye en la vista de contenido del árbol de automatización de la interfaz de usuario.
IsControlElementProperty Cierto El control de la barra de progreso siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario.

Propiedades y patrones de control de Automatización de la interfaz de usuario 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 barra de progreso. 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/Propiedad de patrón Soporte técnico/valor Notas
IValueProvider Depende Los controles de barra de progreso que proporcionan una indicación textual del progreso deben implementar IValueProvider.
IsReadOnly Cierto El valor de esta propiedad siempre es True.
Value Vea las notas. Esta propiedad expone el progreso textual de un control de barra de progreso.
IRangeValueProvider Depende Los controles de barra de progreso que toman un intervalo numérico deben implementar IRangeValueProvider
Minimum 0,0 El valor de esta propiedad es el valor más pequeño en el que se puede establecer el control.
Maximum 100.0 El valor de esta propiedad es el valor más grande en el que se puede establecer el control.
SmallChange Nan Esta propiedad no es necesaria porque los controles de barra de progreso son de solo lectura.
LargeChange Nan Esta propiedad no es necesaria porque los controles de barra de progreso son de solo lectura.

Eventos de Automatización de la interfaz de usuario necesarios

En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario necesarios para ser compatibles con todos los controles de barra de progreso. Para más información sobre los eventos, vea UI Automation Events Overview.

Evento de Automatización de la interfaz de usuario Apoyo Notas
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
AutomationFocusChangedEvent Obligatorio Ninguno
StructureChangedEvent Obligatorio Ninguno

Consulte también

  • Last updated on