Tipo de controle SemanticZoom
Este tópico fornece informações sobre o suporte à Automação de Interface do Usuário para o tipo de controle SemanticZoom.
O Zoom Semântico é uma técnica introduzida no Windows 8 para apresentar e navegar em grandes conjuntos de dados ou conteúdo relacionados em uma única exibição, como um álbum de fotos, uma lista de aplicativos ou um catálogo de endereços. O Zoom Semântico usa dois modos distintos de classificação ou níveis de zoom, para organizar e apresentar o conteúdo. O modo de nível baixo (ou ampliado em) exibe itens em uma estrutura simples e "all-up"; e o modo de alto nível (ou ampliado) exibe itens em grupos, permitindo que o usuário navegue e navegue rapidamente pelo conteúdo. Por exemplo, ampliar uma lista de cidades pode mudar para uma lista de estados que contêm essas cidades. O zoom de uma lista de programas pode mudar para uma lista de grupos de programas lógicos.
Para obter mais informações sobre o Zoom Semântico especificamente, conforme usado para aplicativos da Windows Store, consulte Guidelines for Semmantic Zoom.
O modelo de uso do tipo de controle SemanticZoom é incomum, pois ele existe principalmente para acesso programático. Os clientes de Automação da Interface do Usuário da Microsoft podem monitorar e manipular o controle de Zoom Semântico para controlar o estado ampliado da lista. Os usuários que não estão usando a tecnologia adaptativa normalmente manipulam o controle de Zoom Semântico diretamente por meio de gestos de toque ou atalhos de teclado.
As seções a seguir definem a estrutura de árvore, as propriedades, os padrões de controle e os eventos necessários para o tipo de controle SemanticZoom. Os requisitos de Automação da Interface do Usuário se aplicam a todos os controles de Zoom Semântico em que a estrutura/plataforma da interface do usuário integra o suporte à Automação de Interface do Usuário para tipos de controle e padrões de controle.
Este tópico contém as seções a seguir.
- estrutura de árvore típica
- propriedades relevantes
- padrões e propriedades de controle necessários
- eventos necessários
- comentários
- tópicos relacionados
Estrutura de árvore típica
A tabela a seguir ilustra um controle típico e uma exibição de conteúdo da árvore de Automação da Interface do Usuário que pertence ao tipo de controle SemanticZoom e descreve o que pode ser contido em cada exibição. Para obter mais informações sobre a árvore de Automação da Interface do Usuário, consulte Visão geral da árvore de automação da interface do usuário.
| Modo de Exibição de Controle | Exibição de conteúdo |
|---|---|
|
|
Ou:
| Modo de Exibição de Controle | Exibição de conteúdo |
|---|---|
|
|
Propriedades relevantes
A tabela a seguir lista as propriedades da Automação da Interface do Usuário cujo valor ou definição é especialmente relevante para os controles que implementam o tipo de controle SemanticZoom. Para obter mais informações sobre as propriedades da Automação da Interface do Usuário, consulte Recuperando propriedades de elementos de automação da interface do usuário.
| Propriedade de Automação da Interface do Usuário | Valor | Anotações |
|---|---|---|
| UIA_AutomationIdPropertyId | Confira as anotações. | O valor dessa propriedade deve ser exclusivo entre todos os elementos pares na exibição bruta da árvore de Automação da Interface do Usuário. |
| UIA_BoundingRectanglePropertyId | Confira as anotações. | O retângulo mais externo que contém todo o controle. |
| UIA_ClickablePointPropertyId | Confira as anotações. | Se o controle de lista tiver um ponto clicável (um ponto que pode ser clicado para fazer com que a lista se concentre), esse ponto deverá ser exposto por meio dessa propriedade. Se o valor da propriedade UIA_IsOffscreenPropertyId for VERDADEIRO, tentar recuperar essa propriedade resultará no erro UIA_E_NOCLICKABLEPOINT. |
| UIA_ControlTypePropertyId | SemanticZoom | |
| UIA_IsContentElementPropertyId | VERDADEIRO | |
| UIA_IsControlElementPropertyId | VERDADEIRO | |
| UIA_IsKeyboardFocusablePropertyId | FALSO | |
| UIA_LabeledByPropertyId | Confira as anotações. | Se houver um rótulo de texto estático, essa propriedade deverá expor uma referência a esse controle. |
| UIA_LocalizedControlTypePropertyId | Confira as anotações. | Uma cadeia de caracteres localizada correspondente ao tipo de controle SemanticZoom. O valor padrão é "zoom semântico" para en-US ou inglês (Estados Unidos).
Observação: algumas estruturas concatenou isso como "semanticzoom". |
| UIA_NamePropertyId | Confira as anotações. | Uma cadeia de caracteres vazia é aceitável ou um nome mais útil pode ser fornecido, desde que não contenha o termo zoom semântico, o que tornaria confusa a combinação de tipo de controle e nome. |
Padrões e propriedades de controle necessários
A tabela a seguir lista os padrões de controle de Automação da Interface do Usuário necessários para serem suportados por todos os controles de Zoom Semântico. Para obter mais informações sobre padrões de controle, consulte Visão geral dos padrões de controle de automação da interface do usuário.
| Propriedade Control Pattern/Pattern | Suporte/valor | Anotações |
|---|---|---|
| IToggleProvider | Depende | Os controles de Zoom Semântico dão suporte ao padrão de controle Alternar para permitir que o zoom seja habilitado ou desabilitado. ToggleState_Off corresponde ao estado simples, total e ToggleState_On corresponde ao modo de exibição de alto nível e ampliado. |
Eventos necessários
A tabela a seguir lista os eventos de Automação da Interface do Usuário que os controles de Zoom Semântico são necessários para dar suporte. Para obter mais informações sobre eventos, consulte Visão geral de eventos de automação da interface do usuário.
| Evento de automação da interface do usuário | Anotações |
|---|---|
| UIA_BoundingRectanglePropertyId evento alterado por propriedade. | |
| UIA_IsEnabledPropertyId evento alterado por propriedade. | Se o controle der suporte à propriedade IsEnabled, ele deverá dar suporte a esse evento. |
| UIA_IsOffscreenPropertyId evento alterado por propriedade. | Se o controle der suporte à propriedade IsOffscreen, ele deverá dar suporte a esse evento. |
| UIA_ToggleToggleStatePropertyId evento alterado por propriedade. |
Observações
Se uma interface do usuário tiver um botão visível para alternar o comportamento de controle de Zoom Semântico, esse botão não deverá ter um tipo de controle SemanticZoom. Isso é contra-intuitivo, mas o tipo de controle SemanticZoom caracteriza o contêiner do conteúdo de zoom, não um botão que controla o zoom. (Esse botão pode ser representado simplesmente como um tipo de controle Button com o padrão de controle de alternância de.)