Tipo de control image

  • Artículo

En este tema se proporciona información sobre la compatibilidad de Microsoft Automatización de la interfaz de usuario con el tipo de control Image.

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 fondo o de marca de agua no admitirán el tipo de control Image .

En las secciones siguientes se definen los Automatización de la interfaz de usuario estructura de árbol, propiedades, patrones de control y eventos necesarios para el tipo de control Image. Los requisitos de Automatización de la interfaz de usuario se aplican a todos los controles de imagen 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 imagen 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
Imagen Imagen (depende de si la imagen contiene información, según el valor de la propiedad Identificadores de propiedad del elemento automation )

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 imagen. 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. El punto que se puede hacer clic en el control de imagen debe ser un punto dentro del rectángulo delimitador del control de imagen.
UIA_ControlTypePropertyId Imagen
UIA_HelpTextPropertyId Vea las notas. La propiedad HelpText expone una cadena localizada que describe la apariencia visual real del control u otra información de información sobre herramientas 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, si la imagen es 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 la descripción visual que se establecerá en el control. Esta propiedad debe asignarse a la propiedad Automatización de la interfaz de usuario VisualDescription.
UIA_IsContentElementPropertyId Vea las notas. El control de imagen debe incluirse en la vista de contenido del árbol de UI Automation cuando contiene información significativa aún no expuesta al usuario final.
UIA_IsControlElementPropertyId TRUE El control de image siempre se incluye en la vista de control del árbol de UI Automation.
UIA_IsKeyboardFocusablePropertyId Vea las notas. Si el control puede recibir el foco del teclado, debe admitir esta propiedad.
UIA_ItemStatusPropertyId Vea las notas. Si el control de imagen representa la información del estado sobre un elemento concreto de la pantalla, el control debe incluirse dentro del 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.
UIA_LabeledByPropertyId Vea las notas. Si hay una etiqueta de texto estático, esta propiedad debe exponer una referencia a ese control.
UIA_LocalizedControlTypePropertyId Vea las notas. Cadena localizada correspondiente al tipo de control Image . El valor predeterminado es "image" para en-US o inglés (Estados Unidos).
UIA_NamePropertyId 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 ofrezca un equivalente textual 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 (vea Comentarios). Los marcos de trabajo de interfaz de usuario deben admitir propiedad de texto alternativo o ALT en las imágenes que se pueden establecer desde dentro de su marco de trabajo. Esta propiedad se asignará entonces a la propiedad de nombre de UI Automation.

Patrones de control necesarios

En la tabla siguiente se enumeran los patrones de control Automatización de la interfaz de usuario necesarios para ser compatibles con los controles de imagen. 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 El control de imagen admite el patrón de control GridItem si el control está dentro de un contenedor de cuadrícula.
IInvokeProvider Nunca Si el control de imagen es un objeto que se puede hacer clic, el control debe admitir un tipo de control que admita el patrón de control Invoke , como el tipo de control Button . Para un objeto de imagen que contiene varios objetos que se pueden hacer clic, el elemento (tipo de control image) puede hospedar vínculos secundarios (tipo de control hipervínculo) en el árbol de Automatización de la interfaz de usuario.
ISelectionItemProvider Nunca Los controles de imagen no deben admitir el patrón de control SelectionItem . Si las imágenes forman parte de un contenedor que se puede seleccionar, como un botón que tiene un icono de imagen como contenido, ese contenedor admite el patrón, no la imagen dentro.
ITableItemProvider Depende El control de imagen admite el patrón de control TableItem si el control está dentro de un contenedor que tiene controles de encabezado.

Eventos necesarios

En la tabla siguiente se enumeran los eventos Automatización de la interfaz de usuario que los controles de imagen 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_ItemStatusPropertyId evento de cambio de propiedad. Si el control admite la propiedad ItemStatus , debe admitir este evento.
UIA_NamePropertyId evento de cambio de propiedad.
UIA_StructureChangedEventId

Observaciones

World Wide Web Consortium (W3C) define una imagen decorativa como una que no agrega información al contenido de una página. Para obtener más información, vea el tema W3C sobre imágenes decorativas.

Con respecto a Automatización de la interfaz de usuario:

  • Si una imagen es puramente decorativa, no es interactiva y no transmite información, la imagen:
    • Podría estar o no en el árbol UIA
    • Podría estar o no en la vista sin formato de UIA
    • No debe estar en la vista de control UIA
    • No debe estar en la vista de contenido
    • Podría o no tener un nombre
  • Si una imagen transmite información, pero hay texto claramente asociado que proporciona la misma información (por ejemplo, un botón de reproducción que contiene un gráfico de triángulos que señala a la izquierda junto con el texto "reproducir"), la imagen se considera decorativa y la imagen:
    • Debe estar en la vista sin formato.
    • Debe estar en la vista de control
    • No debe estar en la vista de contenido
    • Podría o no tener un valor en la propiedad Name
    • El texto que también transmite el significado de la imagen debe estar en la vista de contenido.
  • Si una imagen es informativa y transmite detalles que no proporciona ningún texto asociado, la imagen:
    • Debe estar en la vista sin formato.
    • Debe estar en la vista de control
    • Debe estar en la vista de contenido
    • Debe tener un valor de nombre que describa la imagen y su significado.

Conceptual