Tipo de controle SemanticZoom

  • Artigo

Este tópico fornece informações sobre o suporte à Automação da 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 um único modo de exibição, como um álbum de fotos, lista de aplicativos ou 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 baixo nível (ou ampliado) 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 rapidamente e navegue 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 Diretrizes para Zoom Semântico.

O modelo de uso para o tipo de controle SemanticZoom é incomum, pois ele existe principalmente para acesso programático. Os clientes da 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 tecnologia adaptativa normalmente manipulariam 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 de Automação da Interface do Usuário, 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 da Interface do Usuário para tipos de controle e padrões de controle.

Este tópico inclui as seções a seguir.

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.

Exibição de controle Exibição de conteúdo
  • Lista
    • [SemanticZoom]
      • ListItem (0 ou mais)
  • Lista
    • ListItem (0 ou mais)

Ou:

Exibição de controle Exibição de conteúdo
  • [SemanticZoom]
    • Lista
      • ListItem (0 ou mais)
  • Lista
    • ListItem (0 ou mais)

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 Observações
UIA_AutomationIdPropertyId Veja as observaçõ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 Veja as observações. O retângulo mais externo que contém todo o controle.
UIA_ClickablePointPropertyId Veja as observaçõ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 TRUE, tentar recuperar essa propriedade resultará no erro UIA_E_NOCLICKABLEPOINT .
UIA_ControlTypePropertyId SemanticZoom
UIA_IsContentElementPropertyId TRUE
UIA_IsControlElementPropertyId TRUE
UIA_IsKeyboardFocusablePropertyId FALSE
UIA_LabeledByPropertyId Veja as observações. Se houver um rótulo de texto estático, essa propriedade deverá expor uma referência a esse controle.
UIA_LocalizedControlTypePropertyId Veja as observaçõ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). Nota: Algumas estruturas concatenou isso como "semanticzoom".
UIA_NamePropertyId Veja as observaçõ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 da Automação da Interface do Usuário.

Padrão de Controle/Propriedade do Padrão Suporte/Valor Observações
IToggleProvider Depende Os controles de Zoom Semântico dão suporte ao padrão de controle Desativar 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 obrigatórios

A tabela a seguir lista os eventos de Automação da Interface do Usuário aos quais os controles de Zoom Semântico são necessários para dar suporte. Para mais informações sobre eventos, confira Visão geral de eventos de Automação da Interface do Usuário.

Evento de Automação da Interface do Usuário Observações
UIA_BoundingRectanglePropertyId evento com alteração de propriedade.
UIA_IsEnabledPropertyId evento com alteração de propriedade. Se o controle der suporte à propriedade IsEnabled , ele deverá dar suporte a esse evento.
UIA_IsOffscreenPropertyId evento com alteração de propriedade. Se o controle der suporte à propriedade IsOffscreen , ele deverá dar suporte a esse evento.
UIA_ToggleToggleStatePropertyId evento com alteração de propriedade.

Comentários

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 .)

Visão Geral dos Tipos de Controle de Automação de Interface do Usuário

Visão geral de automação da interface do usuário