Compatibilidad de UI Automation para el tipo de control Image
.gif "Nota") Nota |
|---|
Esta documentación está dirigida a desarrolladores de .NET Framework que desean usar las clases administradas de UI Automation definidas en el espacio de nombres System.Windows.Automation.Para obtener información actualizada sobre UI Automation, vea Windows Automation API: UI Automation. |
En este tema se proporciona información sobre la compatibilidad de UI Automation con el tipo de control Image. En la UI Automation, un tipo de control es un conjunto de condiciones que debe cumplir un control para utilizar la propiedad ControlTypeProperty. Las condiciones incluyen instrucciones específicas para la estructura de árbol de UI Automation, los valores de propiedades de UI Automation y los patrones de control.
Los controles de imagen utilizados como iconos, gráficos informativos y gráficos, admitirán el tipo del control Image. Los controles utilizados como fondo o marcas de agua no admiten el tipo de control Image.
En las secciones siguientes se definen la estructura de árbol de UI Automation, las propiedades, los patrones de control y los eventos obligatorios para el tipo de control Image. Los requisitos de UI Automation se aplican a todos los controles de imagen, sean de Windows Presentation Foundation (WPF), Win32 o Windows Forms.
Este tema contiene las secciones siguientes.
- Estructura de árbol de automatización de la interfaz de usuario obligatoria
- Propiedades necesarias de automatización de la interfaz de usuario
- Patrones de control de automatización de la IU obligatorios
- Eventos de automatización de la interfaz de usuario obligatorios
- Temas relacionados
Estructura de árbol de automatización de la interfaz de usuario obligatoria
En la tabla siguiente se muestra la vista de control y la vista de contenido del árbol UI Automation correspondiente a los controles de imagen y se describe qué puede contener cada vista. Para obtener más información sobre el árbol de UI Automation, vea Información general sobre el árbol de la UI Automation.
Vista de control |
Vista de contenido |
|---|---|
Image |
Image (Depende de si la imagen contiene información (se basa en el valor de la propiedad IsContentElement)) |
Propiedades necesarias de automatización de la interfaz de usuario
En la tabla siguiente se muestra la lista de propiedades de UI Automation cuyo valor o definición es especialmente relevante para el tipo de control Image. Para obtener más información sobre las propiedades de UI Automation, vea Propiedades de UI Automation para clientes.
Propiedad de UI Automation |
Valor |
Notas |
|---|---|---|
Vea las notas. |
El valor de esta propiedad debe ser único en todos los controles de una aplicación. |
|
Consulte las notas. |
El rectángulo más externo que contiene el control completo. |
|
Consulte las notas. |
El punto donde hacer clic del control de imagen debe ser un punto contenido dentro del rectángulo delimitador del control de imagen. |
|
Consulte las notas. |
Si el control puede recibir el foco del teclado, debe admitir esta propiedad. |
|
Consulte las notas. |
La propiedad Name se debe exponer para todos los controles de imagen que contienen información. El acceso mediante programación a esta información requiere que se proporcione un equivalente textual al gráfico. Si el control de imagen cumple una función meramente decorativa, únicamente debe aparecer en la vista de control del árbol de UI Automation y no es preciso que tenga nombre. Los marcos de trabajo de interfaz de usuario deben admitir ALT (o propiedad de texto alternativa) en aquellas imágenes que se pueden establecer desde el interior de su marco de trabajo. En este caso, esta propiedad se asignará a la propiedad Name de UI Automation. |
|
Consulte las notas. |
Si hay una etiqueta de texto estática, esta propiedad debe exponer una referencia a ese control. |
|
Image |
Este valor es el mismo para todos los marcos de trabajo de interfaz de usuario. |
|
"image" |
Cadena adaptada que corresponde al tipo de control Image. |
|
Consulte las notas. |
El control de imagen se debe incluir en la vista de contenido del árbol de UI Automation cuando contiene información significativa que todavía no se ha expuesto al usuario final. |
|
True |
El control de imagen siempre se incluye en la vista de control del árbol de UI Automation. |
|
Consulte las notas. |
La propiedad HelpText expone una cadena traducida que describe el aspecto visual real del control (por ejemplo, un cuadrado rojo con un aspa blanca) u otra información sobre herramientas asociada a la imagen. Se debe admitir esta propiedad cuando se necesita una descripción larga para transmitir más información sobre el control de imagen. Por ejemplo, para un gráfico o diagrama complicado. Esta propiedad se asigna a la etiqueta LongDesc de HTML y la etiqueta Desc de SVG (Scalable Vector Graphics). Los programadores que trabajan con controles de imagen deben admitir una propiedad que permita establecer la descripción visual en el control. Esta propiedad se debe asignar a la propiedad VisualDescription de automatización de la interfaz de usuario. |
|
Consulte las notas. |
Si el control de imagen representa información de estado sobre un elemento determinado de la pantalla, el control deberá estar contenido dentro del elemento. Cuando la imagen está contenida en un elemento, ese elemento debe admitir la propiedad de estado y provocar las notificaciones adecuadas cuando cambie el estado. Si una imagen es un control independiente y transmite un estado, se debe admitir esta propiedad. |
Patrones de control de automatización de la IU obligatorios
En la tabla siguiente se muestra una lista de los patrones de control de UI Automation con los que deben ser compatibles todos los controles de imagen. Para obtener más información acerca de los patrones de control, consulte Información general acerca de los patrones de control de automatización de la interfaz de usuario.
Patrón de control |
Compatibilidad |
Notas |
|---|---|---|
Depende |
El control de imagen admite el patrón GridItem si el control está dentro de un contenedor de cuadrícula. |
|
Depende |
El control de imagen admite el patrón TableItem si el control está dentro de un contenedor que tiene controles de encabezado. |
|
Nunca |
Si el control de imagen contiene una imagen donde hacer clic, el control debe admitir un tipo de control que admita el patrón Invoke, tal como el tipo del control Button. |
|
Nunca |
Los controles de imagen no deben admitir el patrón SelectionItem. |
Eventos de automatización de la interfaz de usuario obligatorios
En la tabla siguiente se muestra una lista de los eventos de UI Automation con los que deben ser compatibles todos los controles de imagen. Para obtener más información sobre los eventos, vea Información general sobre eventos de UI Automation.
Evento de UI Automation |
Compatibilidad |
Notas |
|---|---|---|
Nunca |
Ninguno |
|
Nunca |
Ninguno |
|
Nunca |
Ninguno |
|
Nunca |
Ninguno |
|
Evento de cambio de propiedad de BoundingRectangleProperty. |
Obligatorio |
Ninguno |
Evento de cambio de propiedad de IsOffscreenProperty. |
Necesario |
Ninguno |
Evento de cambio de propiedad de IsEnabledProperty. |
Necesario |
Ninguno |
Evento de cambio de propiedad de NameProperty. |
Obligatorio |
Ninguno |
Obligatorio |
Ninguno |
|
Obligatorio |
Ninguno |