Controlo de galeria nas Power Apps

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

Description

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, use um controle Gallery para 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 para 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 na parte superior de um controle Gallery na orientação vertical/retrato.

Todas as alterações feitas no modelo são refletidas em todo o controle Galeria .

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

Limitações

O controle de galeria tem estas limitações:

1. Se um usuário rolar o controle Galeria de altura flexível antes de todos os itens serem carregados, o item que está atualmente em exibição pode ser empurrado para baixo e para fora da exibição quando o carregamento de dados for concluído. Para evitar esse problema, use um controle Gallery padrão em vez da variante de altura flexível .
2. Os seguintes controles não são suportados em uma galeria:
   • Exibir formulário
   • Editar formulário
   • Visualizador de PDF
   • Mosaico do Power BI
   • Editor de rich text
   • Tela rolável (grade fluida)
   • Scanner de código de barras da Web
3. Não é possível adicionar uma galeria dentro de outra galeria se esta já estiver dentro de outra galeria. O nível máximo de nidificação é 2.
4. O TemplateSize mínimo é um. Isso pode fazer com que os controles na Galeria se desviem de seus valores X ou Y esperados, quando você não leva em conta o tamanho do modelo.
5. Se gerar uma aplicação automaticamente a partir de dados, guardar a aplicação e, em seguida, reabri-la, a galeria de navegação poderá não mostrar imediatamente quaisquer dados. Para resolver esse problema, digite pelo menos um caractere na caixa de pesquisa e, em seguida, exclua o texto que você digitou. A galeria mostrará os dados conforme o esperado.
6. Se uma galeria incluir um controle ComboBox, DatePicker, Slider ou Toggle com uma OnChange regra que corrija a mesma fonte de dados ou coleção que a galeria, isso poderá levar a um desempenho inesperado ou reduzido. Isso ocorre porque uma OnChange regra que corrige a fonte de dados da galeria pode criar um ciclo interminável de aplicação de patches e recarregamentos. Para evitar esse problema, é aconselhável não usar OnChange regras quando esses controles são colocados dentro de uma galeria.

Propriedades chave

Padrão – O item ou registro da fonte de dados a ser selecionado na galeria quando o aplicativo for iniciado.

Itens – A fonte de dados que aparece em um controle, como uma galeria, uma lista ou um gráfico.

Selecionado – O item selecionado.

Propriedades adicionais

AccessibleLabel – Etiqueta da galeria (não os itens que ela contém) para leitores de tela. Deve descrever qual é a lista de itens.

AllItems – Itens que são carregados na galeria. Isso pode ser menor do que o número real de itens da fonte de dados. Mais itens podem ser carregados quando a galeria é rolada. AllItems também contém controles que são usados em cada item de galeria.

AllItemsCount - Contagem de itens que são carregados na galeria. Isso pode ser menor do que o número real de itens da fonte de dados. Mais itens podem ser carregados quando a galeria é rolada.

BorderColor – A cor da borda de um controle.

BorderStyle – Se a borda de um controle é Sólida, Tracejada, Pontilhada ou Nenhuma.

BorderThickness – A espessura da borda de um controle.

DelayItemLoading - Atrase o carregamento de itens (linhas) até que a tela seja carregada pela primeira vez.

DisplayMode – Se o controle permite a entrada do usuário (Editar), exibe apenas dados (View) ou está desativado (Disabled).

Preenchimento – A cor de fundo de um controlo.

Altura – A distância entre as bordas superior e inferior de um controle.

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

LoadingSpinner (Nenhum, Controles ou Dados) - Quando Nenhum, o spinner não será mostrado. Quando controla | Os dados, spinner serão mostrados quando ocorrer um passo de renderização que resulte em linhas vazias visíveis.

LoadingSpinnerColor - A cor de preenchimento do spinner de carga. O padrão é definido como BorderColor.

NavigationStep – Até onde uma galeria rola se sua propriedade ShowNavigation estiver definida como true e o usuário selecionar uma seta de navegação em qualquer extremidade 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ê seleciona 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 aparece 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 aparece quando o usuário passa o mouse sobre uma galeria.

TemplateFill – A cor de fundo de uma galeria.

TemplatePadding – A distância entre 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. O tamanho mínimo é um.

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

Visível – Se um controle aparece ou está oculto.

Largura – A distância entre as bordas esquerda e direita de um controle.

WrapCount – Número de itens mostrados 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 de seu contêiner ou tela pai.

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

Funções relacionadas

Filter( DataSource, Fórmula )

Reset( Control ) - Redefine sua galeria de volta ao seu estado inicial. O estado inicial inclui rolar até o primeiro item e selecionar o primeiro item ou padrão, se presente.

Examples

Mostrar e filtrar dados

• Mostrar texto
• Mostrar imagens
• Filtrar dados selecionando uma opção de lista
• Filtrar dados ajustando um controle deslizante

Obter dados do usuário

• Obter texto
• Obter imagens
• Obter fotos
• Obter sons
• Obter desenhos

Diretrizes de acessibilidade

Contraste de cor

Se clicar em qualquer lugar em um item da galeria for para selecioná-lo, deve haver um contraste de cor adequado entre:

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

Suporte a leitor de ecrã

• AccessibleLabel deve estar presente.

  Observação

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

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

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

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

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

Suporte de teclado

• Considere definir ShowScrollbar como true. Na maioria dos dispositivos com tela sensível ao toque, a barra de rolagem não será exibida até que a rolagem comece.

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

  Observação

  Os controles fora da galeria não são considerados na ordem de navegação do teclado dentro da galeria. Os controles TabIndex dentro de uma galeria têm escopo. Consulte as propriedades de acessibilidade para saber mais.

Consulte também

Use o rotador DelayItemLoading e Loading para melhorar o desempenho na Galeria