Partilhar via

Controlo Galeria no Power Apps

  • Artigo

Um controlo que contém outros controlos e mostra um conjunto de dados.

Descrição

Um controlo de Galeria pode mostrar vários registos de uma origem de dados, e cada registo pode conter vários tipos de dados. Por exemplo, use um controlo Galeria para mostrar vários contactos, em que cada item mostra as informações de contacto que incluem um nome, um endereço e número de telefone para cada contacto.

Cada campo de dados aparece num controlo separado do controlo de Galeria. Pode também configurar esses controlos no modelo correspondente. O modelo aparece como o primeiro item na Galeria:

  • Na margem esquerda de um controlo de Galeria na orientação horizontal/paisagem.
  • E na parte superior de um controlo de Galeria na orientação vertical/retrato.

Quaisquer alterações efetuadas no modelo são refletidas em todo o controlo Galeria.

Estão disponíveis modelos predefinidos para mostrar imagens e texto numa galeria e uma galeria para itens de altura variável.

Limitações

O controlo da galeria tem as seguintes limitações:

  1. Se um utilizador deslizar o controlo Galeria de altura flexível antes de todos os itens serem carregados, o item que está em vista no momento poderá ser empurrado e retirado da vista quando o carregamento dos dados estiver concluído. Para evitar este problema, utilize um controlo Galeria padrão em vez da variante de Altura flexível.
  2. Os controlos seguintes não são suportados numa galeria:
  3. Só pode adicionar uma galeria dentro de outra galeria.
  4. O TemplateSize mínimo é um. Isto pode fazer com que os controlos da Galeria se desviem dos valores X ou Y esperados, quando leva em consideração o tamanho do modelo.
  5. Se gerar uma aplicação automaticamente a partir de dados, guarde a aplicação e, em seguida, volte a abri-la, a galeria de procura poderá não apresentar quaisquer dados imediatamente. Para resolver este problema, escreva pelo menos um caráter na caixa de pesquisa e, em seguida, elimine o texto que introduziu. A galeria irá então mostrar os dados, conforme esperado.
  6. Se uma galeria incluir um controle ComboBox, DatePicker, Slider ou Toggle com uma OnChange regra que corrija a mesma origem de dados ou coleção que a galeria, isso pode levar a um desempenho inesperado ou reduzido. Isso ocorre porque uma OnChange regra que corrige o origem de dados da galeria pode criar um ciclo interminável de aplicação de patches e recarga. Para evitar esse problema, é aconselhável não usar OnChange regras quando esses controles são colocados dentro de uma galeria.

Propriedades chave

Default – o item ou o registo da origem de dados a selecionar na Galeria quando a aplicação é iniciada.

Items – a origem de dados que aparece num controlo, como uma galeria, uma lista ou um gráfico.

Selected – o item selecionado.

Propriedades adicionais

AccessibleLabel – etiqueta da galeria (não os itens que contém) para leitores de ecrã. Deve descrever o que é a lista de itens.

AllItems – Itens que são carregados na galeria. Este valor pode ser inferior ao número real de Itens da origem de dados. Podem ser carregados mais itens quando a galeria for deslocada. AllItems também contém controlos que são utilizados em cada item da galeria.

AllItemsCount - Contagem de itens que são carregados na galeria. Este valor pode ser inferior ao número real de Itens da origem de dados. Podem ser carregados mais itens quando a galeria for deslocada.

BorderColor – a cor do limite de um controlo.

BorderStyle – se o limite do controlo é Sólido, Tracejado, Com pontos ou Nenhum.

BorderThickness – a espessura do limite de um controlo.

DelayItemLoading - atrasar o carregamento de itens (linhas) até após o ecrã ser carregado pela primeira vez.

DisplayMode – se o controlo permite a intervenção do utilizador (Editar), apenas apresenta os dados (Visualizar), ou está desativado (Desativado).

Fill – a cor de fundo de um controlo.

Height – a distância entre as margens superiores e inferiores de um controlo.

ItemAccessibleLabel – etiqueta de cada item de galeria para leitores de ecrã. Deve descrever o que cada item é.

LoadingSpinner (nenhum, controlos ou dados) - quando for Nenhum, o ícone de progresso não será mostrado. Quando estiver em Controlos | Dados, o controlo giratório será apresentado quando ocorrer uma passagem de composição que resulte em linhas vazias visíveis.

LoadingSpinnerColor - a cor de preenchimento do ícone de progresso de carregamento. Predefinição está definido como BorderColor.

NavigationStep – até que ponto uma galeria se desloca, se a respetiva propriedade ShowNavigation estiver definida como verdadeiro e o utilizador selecionar uma seta de navegação em cada extremidade dessa galeria.

Selectable – se os itens da Galeria podem ser selecionados. Quando definido como true, os leitores de ecrã identificam a galeria como uma lista selecionável. E seleciona um item selecionando-o. Quando definido como falso, os leitores de ecrã identificam a galeria como uma lista normal 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 utilizador possa percorrer os itens na galeria selecionando uma seta.

ShowScrollbar – se uma barra de deslocamento aparece quando o utilizador passa o rato por cima de uma galeria.

TemplateFill – a cor de fundo de uma galeria.

TemplatePadding – a distância entre os itens numa galeria.

TemplateSize – a altura do modelo de uma galeria na orientação vertical/retrato. Ou a largura do modelo de uma galeria na orientação horizontal/paisagem. O tamanho mínimo é um.

Transition – o efeito visual (Destaque, Push, ou Nenhum) quando o utilizador passa o rato por cima de um item numa galeria.

Visible – se um controlo é apresentado ou está oculto.

Width – a distância entre as margens esquerda e direita de um controlo.

WrapCount – o número de itens mostrados por linha ou coluna, com base no esquema horizontal ou vertical.

X - a distância entre o limite esquerdo do componente de um controlo e o limite esquerdo do contentor ou ecrã principal.

Y - a distância entre o limite superior do componente de um controlo e o limite superior do contentor ou ecrã principal.

Filtrar ( DataSource, Fórmula )

Redefinir ( controlo ) - redefine a sua galeria para o estado inicial. O estado inicial inclui o deslizar para o primeiro item e a seleção do primeiro item ou predefinição, se presente.

Nota

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

Exemplos

Mostrar e filtrar dados

Obter dados do utilizador

Diretrizes de acessibilidade

Contraste de cor

Se o clicar em qualquer lugar num item da galeria tiver por objetivo selecioná-lo, terá de existir contraste de cor adequado entre:

  • BorderColor e a cor fora da galeria (se existir um limite).
  • Fill e a cor fora da galeria (se não existir um limite).

Suporte a leitor de ecrã

  • AccessibleLabel deve estar presente.

    Nota

    Os leitores de ecrã irão anunciar quando forem efetuadas alterações nos itens da galeria. AccessibleLabel também é mencionado. O que permite fornecer contexto para o anúncio e é ainda mais importante quando existem várias galerias no mesmo ecrã.

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

  • Defina o valor de Selectable como true se pretender que os utilizadores selecionem um item de galeria. Caso contrário, defina esse valor como falso.

  • Quando um item de galeria contém vários controlos, utilize ItemAccessibleLabel para fornecer um resumo dos conteúdo dos itens de galeria.

  • Selectable deverá ser definido de forma apropriada, consoante os utilizadores se destinam a selecionar um item de galeria.

Suporte de teclado

  • Considere definir ShowScrollbar como verdadeiro. Na maioria dos dispositivos de ecrã tátil, a barra de deslocamento não será mostrada até começar o deslocamento.

  • Se clicar em qualquer lugar num item da galeria tiver por objetivo selecioná-lo, deverá também existir forma de os utilizadores do teclado selecionarem o item da galeria. Por exemplo, adicionar um Botão que tenha a propriedade OnSelect definida como Select(Parent).

    Nota

    Os controlos fora da galeria não são considerados na ordem de navegação do teclado na galeria. Os controlos TabIndex dentro de uma galeria estão confinados. Veja propriedades de acessibilidade para obter mais informações.

Consulte também

Utilizar o controlo giratório DelayItemLoading e Loading para melhorar o desempenho na Galeria

Nota

Pode indicar-nos as suas preferências no que se refere ao idioma da documentação? Responda a um breve inquérito. (tenha em atenção que o inquérito está em inglês)

O inquérito irá demorar cerca de sete minutos. Não são recolhidos dados pessoais (declaração de privacidade).