Compartir a través de

Soporte para la automatización de la interfaz de usuario respecto al tipo de control de imagen

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 Image. 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 de árbol de UI Automation , los valores de propiedad de esta y los patrones de control.

Los controles de imagen usados como iconos, gráficos informativos y gráficos admitirán el tipo de control Image. Los controles usados como imágenes de marca de agua o de fondo no admitirán el tipo de control Image.

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 Image. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de imagen, 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 imagen 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
Imagen Imagen (depende de si la imagen contiene información (basada en el valor de IsContentElement la propiedad))

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 el tipo de control Image. 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 punto clicable del control de imagen debe estar dentro del rectángulo delimitador del mismo.
IsKeyboardFocusableProperty Vea las notas. Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
NameProperty Vea las notas. La propiedad Name debe exponerse para todos los controles de imagen que contienen información. El acceso mediante programación a esta información requiere que se proporcione un texto equivalente al gráfico. Si el control de imagen es puramente decorativo, solo debe aparecer en la vista de control del árbol de automatización de la interfaz de usuario y no es necesario tener un nombre. Los frameworks de interfaz de usuario deben admitir una propiedad de texto alternativo o ALT en imágenes que puedan ser configuradas dentro de su framework. Esta propiedad se asignará entonces a la propiedad de nombre de UI Automation.
LabeledByProperty Vea las notas. Si hay una etiqueta de texto estático, esta propiedad debe exponer una referencia a ese control.
ControlTypeProperty Imagen Este valor es el mismo para todos los marcos de trabajo de la interfaz de usuario.
LocalizedControlTypeProperty "imagen" Cadena localizada que corresponde al tipo de control Image.
IsContentElementProperty Vea las notas. El control de imagen debe incluirse en la vista de contenido del árbol de automatización de la interfaz de usuario cuando contiene información significativa que aún no está expuesta al usuario final.
IsControlElementProperty Cierto El control de imagen siempre se incluye en la vista de control del árbol de automatización de la interfaz de usuario.
HelpTextProperty Vea las notas. La propiedad HelpText expone una cadena localizada que describe la apariencia visual real del control (por ejemplo, un cuadrado rojo con una "X" blanca) u otra información contextual asociada a la imagen.

Esta propiedad debe admitirse cuando se necesita una descripción larga para transmitir más información sobre el control de imagen. Por ejemplo, un diagrama o gráfico complicado. Esta propiedad se asigna a la etiqueta LongDesc HTML y a la etiqueta Desc de gráficos vectoriales escalables (SVG). Los desarrolladores que trabajan con controles de imagen deben admitir una propiedad para permitir que la descripción visual se establezca en el control. Esta propiedad debe asignarse a la propiedad VisualDescription de automatización de la interfaz de usuario.
ItemStatusProperty Vea las notas. Si el control de imagen representa información de estado sobre un elemento determinado en la pantalla, el control debe estar incluido en el elemento. Cuando la imagen está contenida en un elemento, el elemento debe admitir la propiedad status y generar notificaciones adecuadas cuando cambie el estado.

Si una imagen es un control independiente y transmite el estado, se debe admitir esta propiedad.

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 todos los controles de imagen. Para más información sobre los patrones de control, vea UI Automation Control Patterns Overview.

Patrón de control Apoyo Notas
IGridItemProvider Depende El control de imagen admite el patrón Grid Item si el control está dentro de un contenedor de cuadrícula.
ITableItemProvider Depende El control de imagen admite el patrón Table Item si el control está dentro de un contenedor que tiene controles de encabezado.
IInvokeProvider Nunca Si el control de imagen contiene una imagen en la que se puede hacer clic, el control debe admitir un tipo de control que admita el patrón Invoke, como el tipo de control Button.
ISelectionItemProvider Nunca Los controles de imagen no deben admitir el patrón Selection Item.

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 admitir todos los controles de imagen. Para más información sobre los eventos, vea UI Automation Events Overview.

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

Consulte también

  • Last updated on