Controle Gallery em aplicativos de tela

Um controle que contém outros controles e mostra um conjunto de dados.

Descrição

Um controle Gallery pode mostrar vários registros de uma fonte de dados, e cada registro pode conter vários tipos de dados. Por exemplo, um controle de Gallery pode mostrar vários contatos, com cada item mostrando informações de contato que incluem um nome, um endereço e um número de telefone de cada contato.

Cada campo de dados aparece em um controle separado dentro do controle Gallery. E você pode configurar esses controles em seu modelo. O modelo aparece como o primeiro item dentro da galeria:

  • Na borda esquerda de um controle Gallery na orientação horizontal/paisagem.
  • E no topo de um controle Gallery na orientação vertical/retrato.

Quaisquer alterações feitas no modelo são refletidas em todo o controle Gallery.

Modelos predefinidos para mostrar imagens e texto em uma galeria e uma galeria com itens de altura variável estão disponíveis.

Limitações

Se um usuário rolar o controle de galeria de Altura flexível, antes que todos os itens sejam carregados, o item que está sendo exibido no momento pode ser empurrado para baixo e para fora da vista quando o carregamento dos dados for concluído. Para evitar esse problema, use um controle padrão Gallery, em vez da variante de Altura flexível.

Propriedades-chave

Default – o item ou o registro da fonte de dados a ser selecionado na galeria quando o aplicativo é iniciado.

Items – a fonte de dados exibida em um controle como uma galeria, uma lista ou um gráfico.

Selected – o item selecionado.

Propriedades adicionais

AccessibleLabel - Rótulo da galeria (não os itens que ela contém) para os leitores de tela. Deve descrever o que são as listas de itens.

AllItems – todos os itens em uma galeria, incluindo os valores de controle adicionais que fazem parte do modelo da galeria.

BorderColor – a cor da borda do controle.

BorderStyle – se a borda do controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – a espessura da borda do controle.

DelayItemLoading - atrasa o carregamento dos itens (linhas) até depois que a tela for carregada pela primeira vez.

DisplayMode – se o controle permite a entrada do usuário (Editar), apenas exibe dados (Exibir) ou está desabilitado (Desabilitado).

Fill – a cor da tela de fundo de um controle.

Height – a distância entre a parte superior do controle e as bordas inferiores.

ItemAccessibleLabel – rótulo de cada item da galeria para leitores de tela. Deve descrever o que é cada item.

LoadingSpinner ( Nenhum, Controles ou Dados) - Quando definido como Nenhum, o botão giratório não será exibido. Quando for Controles | Dados, o botão giratório será mostrado quando ocorrer uma renderização que resulte em linhas vazias visíveis.

LoadingSpinnerColor - A cor de preenchimento do botão giratório de carregamento. Por padrão, é definido como BorderColor.

NavigationStep – o quão longe uma galeria é rolada se a propriedade ShowNavigation estiver definida como true e o usuário selecionar uma seta de navegação no final dessa galeria.

Selecionável - se os itens da galeria podem ser selecionados. Quando definido como true, os leitores de tela identificam a galeria como uma lista selecionável. E você escolhe um item, selecionando-o. Quando definido como false, os leitores de tela identificam a galeria como uma lista regular e a seleção de um item não a seleciona.

ShowNavigation – se uma seta é exibida em cada extremidade de uma galeria para que um usuário possa percorrer os itens na galeria selecionando uma seta.

ShowScrollbar – se uma barra de rolagem é exibida quando o usuário passa o mouse sobre uma galeria.

TemplateFill – a cor da tela de fundo de uma galeria.

TemplatePadding – a distância entre os itens em uma galeria.

TemplateSize - A altura do modelo para uma galeria na orientação vertical/retrato. Ou a largura do modelo para uma galeria na orientação horizontal/paisagem.

Transition – o efeito visual (Pop, Push ou None) quando o usuário passa o mouse sobre um item em uma galeria.

Visible – se um controle é exibido ou está oculto.

Width – a distância entre as bordas esquerda e direita de um controle.

WrapCount – número de itens exibidos por linha ou coluna com base no layout horizontal ou vertical.

X – a distância entre a borda esquerda de um controle e a borda esquerda da respectiva tela ou contêiner pai.

Y – a distância entre a borda superior de um controle e a borda superior da tela ou contêiner pai.

Filter( DataSource, Formula )

Reset( Control ) - Redefine sua galeria de volta ao seu estado inicial. O estado inicial inclui a rolagem para o primeiro item e a seleção do primeiro item ou padrão, se presente.

Observação

O controle Reset não redefine recursivamente todos os filhos da galeria.

Exemplos

Exibir e filtrar dados

Obter dados do usuário

Diretrizes de acessibilidade

Contraste de cores

Se clicar em qualquer lugar de um item da galeria significa selecioná-lo, é preciso haver contraste de cores adequado entre:

  • BorderColor e a cor fora da galeria (se houver borda).
  • Fill e a cor fora da galeria (se não houver borda).

Suporte ao leitor de tela

  • AccessibleLabel precisa estar presente.

    Observação

    Leitores de tela anunciarão quando os itens na galeria forem alterados. O AccessibleLabel também é mencionado. Isso fornece contexto para o anúncio e é ainda mais importante quando há várias galerias na mesma tela.

  • Quando um item da galeria contém vários controles, use ItemAccessibleLabel para mostrar o conteúdo dos itens da galeria.

  • Defina o valor de Selecionável como true, se você deseja que os usuários selecionem um item da galeria. Caso contrário, defina esse valor como false.

  • Quando um item da galeria contém vários controles, use ItemAccessibleLabel para fornecer um resumo do conteúdo de item da galeria.

  • Selecionável deve ser definido adequadamente, dependendo se os usuários devem selecionar um item da galeria.

Suporte de teclado

  • Defina ShowScrollbar como true. Na maioria dos dispositivos de tela touch, a barra de rolagem não aparecerá até a rolagem começar.

  • Se clicar em qualquer lugar em um item da galeria significa selecioná-lo, será preciso haver também uma maneira para os usuários de teclado selecionarem o item da galeria. Por exemplo, ao adicionar um Button que tem sua propriedade OnSelect definida como Select(Parent).

    Observação

    Controles externos à galeria não são considerados na ordem de navegação de teclado interna da galeria. O controles TabIndex dentro de uma galeria estão no escopo. Consulte as propriedades de acessibilidade para saber mais.

Consulte também

Usar o controle giratório DelayItemLoading e Loading para melhorar o desempenho na Galeria