Nota:
El acceso a esta página requiere autorización. Puede intentar iniciar sesión o cambiar directorios.
El acceso a esta página requiere autorización. Puede intentar cambiar los directorios.
En este tema se proporciona información sobre la compatibilidad de automatización de la interfaz de usuario con el tipo de control semanticZoom .
El zoom semántico es una técnica introducida en Windows 8 para presentar y navegar por grandes conjuntos de datos relacionados o contenido dentro de una sola vista, como un álbum de fotos, una lista de aplicaciones o una libreta de direcciones. El zoom semántico usa dos modos distintos de clasificación, o niveles de zoom, para organizar y presentar el contenido. El modo de bajo nivel (o zoom en) muestra elementos en una estructura plana y "todo hacia arriba" ; y el modo de alto nivel (o alejar) muestra elementos en grupos, lo que permite al usuario navegar y examinar rápidamente el contenido. Por ejemplo, el zoom de una lista de ciudades podría cambiar a una lista de estados que contienen esas ciudades. Acercar una lista de programas puede cambiar a una lista de grupos de programas lógicos.
Para obtener más información sobre el zoom semántico específicamente como se usa para las aplicaciones de la Tienda Windows, consulta Directrices para zoom semántico.
El modelo de uso del SemanticZoom tipo de control es inusual en que existe principalmente para el acceso mediante programación. Los clientes de Automatización de la interfaz de usuario de Microsoft pueden supervisar y manipular el control Zoom semántico para controlar el estado de zoom de la lista. Los usuarios que no usan tecnología de asistencia normalmente manipularían el control Zoom semántico directamente a través de gestos táctiles o métodos abreviados de teclado.
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 SemanticZoom. Los requisitos de automatización de la interfaz de usuario se aplican a todos los controles de zoom semántico en los que la plataforma o plataforma de la interfaz de usuario integra la compatibilidad de automatización de la interfaz de usuario con los tipos de control y los patrones de control.
Este tema contiene las secciones siguientes.
- estructura de árbol típica
- de propiedades pertinentes
- de propiedades y patrones de control necesarios
- eventos necesarios
- comentarios
- temas relacionados
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 la SemanticZoom tipo de control 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 |
|---|---|
|
|
O:
| Vista de control | Vista de contenido |
|---|---|
|
|
Propiedades pertinentes
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 que implementan el SemanticZoom tipo de control. Para obtener más información sobre las propiedades de automatización de la interfaz de usuario, consulte Recuperar propiedades de elementos de automatización de la interfaz de usuario.
| Ui Automation (propiedad) | 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. | Rectángulo más externo que contiene todo el control. |
| UIA_ClickablePointPropertyId | Vea las notas. | Si el control de lista tiene un punto en el que se puede hacer clic (un punto que se puede hacer clic para que la lista tome el foco), ese punto debe exponerse a través de esta propiedad. Si el valor de la propiedad UIA_IsOffscreenPropertyId es TRUE, al intentar recuperar esta propiedad se produce el error UIA_E_NOCLICKABLEPOINT. |
| UIA_ControlTypePropertyId | SemanticZoom | |
| UIA_IsContentElementPropertyId | VERDADERO | |
| UIA_IsControlElementPropertyId | VERDADERO | |
| UIA_IsKeyboardFocusablePropertyId | FALSO | |
| 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 semanticZoom . El valor predeterminado es "zoom semántico" para en-US o inglés (Estados Unidos).
Nota: Algunos marcos concatenaron esto como "semanticzoom". |
| UIA_NamePropertyId | Vea las notas. | Una cadena vacía es aceptable o se puede proporcionar un nombre más útil, siempre y cuando no contenga el término zoom semántico , lo que haría que la combinación del tipo de control y el nombre resultaran confusos. |
Patrones y propiedades de control 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 zoom semántico. 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 pattern | Compatibilidad/valor | Notas |
|---|---|---|
| IToggleProvider | Depende | Los controles de zoom semántico admiten el patrón de control de alternancia para permitir que el zoom se habilite o deshabilite. ToggleState_Off corresponde al estado plano, todo hacia arriba y ToggleState_On corresponde a la vista de alto nivel y alejada. |
Eventos necesarios
En la tabla siguiente se enumeran los eventos de automatización de la interfaz de usuario que se requieren controles de zoom semántico para admitir. Para obtener más información sobre los eventos, consulte ui Automation Events Overview.
| Evento de automatización de la interfaz de usuario | Notas |
|---|---|
| UIA_BoundingRectanglePropertyId evento de cambio de propiedad. | |
| UIA_IsEnabledPropertyId evento de cambio de propiedad. | Si el control admite la propiedadIsEnabled, debe admitir este evento. |
| UIA_IsOffscreenPropertyId evento de cambio de propiedad. | Si el control admite la propiedad IsOffscreen, debe admitir este evento. |
| UIA_ToggleToggleStatePropertyId evento de cambio de propiedad. |
Observaciones
Si una interfaz de usuario tiene un botón visible para alternar el comportamiento del control zoom semántico, este botón no debe tener un SemanticZoom tipo de control. Esto es contra intuitivo, pero el SemanticZoom tipo de control caracteriza el contenedor del contenido de zoom, no un botón que controla el zoom. (Este botón podría representarse simplemente como un Tipo de control Botón con el patrón de control Alternar).