Controle de tabela de dados no Power Apps

Mostra um conjunto de dados em um formato tabular.

Description

O controle Tabela de dados mostra um conjunto de dados em um formato que inclui cabeçalhos de coluna para cada campo que o controle mostra. Como um criador de aplicativos, você tem controle total sobre quais campos aparecem e em que ordem. Assim como o controle Galeria , o controle Tabela de dados mantém uma propriedade Selecionada que aponta para a linha selecionada. Portanto, você pode vincular o controle de tabela de dados a outros controles.

Limitações

O controle da tabela de dados tem estas limitações:

• Se você copiar e colar um controle tabela de dados para o qual a propriedade Items é definida como uma fórmula que contém uma função Filter , a fórmula para a propriedade Items no novo controle Tabela de Dados acaba com nomes de campo que contêm um sufixo _1 . Isso torna os nomes de campo inválidos e resulta em nenhum dado exibido na tabela de dados. Para contornar esse problema, antes de copiar o controle, confirme se a função Filtro não faz referência a nenhum campo na fonte de dados que tenha o mesmo nome de uma coluna no controle Tabela de Dados . Se isso acontecer, renomeie a coluna no controle Tabela de Dados . Como alternativa, remova o sufixo _1 dos nomes de campo inválidos para que eles correspondam aos nomes na tabela.

Capabilities

O Power Apps introduziu o controle de tabela de dados em 5 de maio de 2017. Esta seção fornece informações sobre recursos com suporte e recursos que não têm suporte.

Agora disponível

• Os dados em um controle de tabela de dados são somente leitura.
• Uma única linha é sempre selecionada em um controle de tabela de dados .
• Vincule um controle de tabela de dados a uma fonte de dados conectada ou local.
• Ajuste as larguras de coluna em um controle de tabela de dados enquanto executa o aplicativo, embora suas alterações não sejam salvas.
• Um conjunto de campos padrão aparece em um controle de tabela de dados quando você o vincula a um conector que implementou essa funcionalidade, como o Microsoft Dataverse. Em seguida, você pode mostrar ou ocultar esses campos e outros, conforme necessário.
• Personalize a largura da coluna e o texto do título.
• Mostrar hiperlinks em um controle de tabela de dados .
• Copie e cole um controle de tabela de dados .

Ainda não disponível

• Personalize o estilo de colunas individuais.
• Adicione um controle de tabela de dados em um controle de formulário.
• Altere a altura de todas as linhas.
• Mostrar imagens em um controle de tabela de dados .
• Mostrar campos de tabelas relacionadas.
• Use a funcionalidade interna para filtrar e classificar dados por título de coluna.
• Adicione um controle de tabela de dados em um controle da Galeria .
• Edite dados no controle de tabela de dados .
• Selecione várias linhas.

Problemas conhecidos

• Nenhum dado será exibido se você usar a função FirstN na propriedade Items .

Principais propriedades

• Itens – A fonte de dados que aparece no controle da tabela de dados .
• Selecionado – a linha selecionada no controle da tabela de dados .

Outras propriedades

• Largura Automática – A propriedade de uma coluna dentro de uma tabela de dados a ser definida se a largura da coluna deve ser automática ou manual.
• BorderColor – A cor da borda do controle da tabela de dados .
• BorderStyle – O estilo da borda do controle de tabela de dados . As opções são Solid, Dashed, Dotted e None.
• BorderThickness – A espessura da borda do controle da tabela de dados .
• Cor – a cor do texto padrão para todas as linhas de dados.
• FieldDisplayName – A propriedade de uma coluna dentro de uma tabela de dados que define o nome de exibição da coluna selecionada.
• Preenchimento – a cor da tela de fundo padrão para todas as linhas de dados.
• Fonte – a fonte padrão para todas as linhas de dados.
• FontWeight – O peso da fonte padrão para todas as linhas de dados.
• HeadingColor – A cor do texto dos títulos de coluna.
• HeadingFill – A cor da tela de fundo dos títulos de coluna.
• HeadingFont – A fonte dos títulos de coluna.
• HeadingFontWeight – O peso da fonte dos títulos de coluna.
• HeadingSize – O tamanho da fonte dos títulos de coluna.
• Altura – a distância entre as bordas superior e inferior do controle da tabela de dados.
• HoverColor – A cor do texto da linha em que o ponteiro do mouse está apontando.
• HoverFill – A cor da tela de fundo da linha em que o ponteiro do mouse está apontando.
• IsHyperlink – A propriedade de uma coluna dentro de uma tabela de dados que define se a coluna selecionada deve estar no formato de hiperlink ou não.
• NoDataText – A mensagem que o usuário recebe quando não há registros a serem mostrados no controle de tabela de dados .
• Ordem – A propriedade de uma coluna dentro de uma tabela de dados que determina a ordem da coluna respectiva para outras colunas. A ordem começa da esquerda para a direita com o valor da primeira ordem de coluna de 1.
• SelectedColor – A cor do texto na linha selecionada.
• SelectedFill – A cor da tela de fundo da linha selecionada.
• Tamanho – o tamanho da fonte padrão para todas as linhas de dados.
• Texto – A propriedade de uma coluna dentro de uma tabela de dados que define o valor de texto dos dados a serem exibidos dentro da coluna selecionada.
• Visível – um valor que determina se o controle de tabela de dados aparece ou está oculto.
• Largura – a distância entre as bordas esquerda e direita do controle da tabela de dados.
• X – a distância entre a borda esquerda do controle de tabela de dados e a borda esquerda de seu contêiner pai (ou a borda esquerda da tela, se não houver nenhum contêiner pai).
• Y – A distância entre a borda superior do controle da tabela de dados e a borda superior de seu contêiner pai (ou a borda superior da tela, se não houver nenhum contêiner pai).

Funções relacionadas

• Filter(DataSource, Formula)(DataSource, Formula)
• Search(DataSource, SearchString, Column)(DataSource, SearchString, Column)

Exemplos

Uso Básico

1. Crie um aplicativo tablet em branco.

2. Na guia Inserir , clique ou toque na tabela Dados.

   

   Um controle de tabela de dados é adicionado à tela.

3. Renomeie o controle de tabela de dadosSalesOrderTable e redimensione-o para que ele cubra toda a tela.

4. No painel direito, selecione Fontes de dados e selecione Pedidos de vendas. Se a tabela não estiver listada, pesquise a tabela e conecte-se ao Microsoft Dataverse.

   

   O controle tabela de dados agora está anexado à fonte de dados do pedido de vendas . Vários campos iniciais aparecem no controle de tabela de dados , pois estamos usando um conector que dá suporte a essa funcionalidade.

   

5. No painel direito, marque uma ou mais caixas de seleção para mostrar ou ocultar campos individuais.

   Por exemplo, marque a caixa de seleção ao lado de CustomerPurchaseOrderReference para ocultar esse campo.

6. No painel direito, reordene os campos arrastando-os para cima ou para baixo.

   

   O controle SalesOrderTable mostra os campos na ordem especificada.

   

Reestilize o cabeçalho para o controle de tabela de dados

1. Enquanto o controle tabela de dados está selecionado, no painel direito, clique ou toque na guia Avançado .

2. Clique ou toque no campo da propriedade HeadingFill e altere o valor para RGBA(62,96.170,1).

3. Clique ou toque no campo da propriedade HeadingColor e altere o valor para Branco.

4. Clique ou toque no campo da propriedade HeadingSize e altere o valor para 14.

   

Conectar um controle de tabela de dados a outro controle

1. Adicione um controle editar formulário à tela.

2. Redimensione a tabela de dados e edite os controles de formulário para que o controle tabela de dados apareça na parte esquerda da tela e o controle Editar formulário apareça na parte direita da tela.

   

3. Enquanto o Form1 estiver selecionado, no painel direito, altere o número de colunas para 1.

4. Conecte o Form1 à fonte de dados do pedido de vendas .

   Vários campos iniciais aparecem no Form1.

   

5. No painel direito, clique ou toque na guia Avançado .

6. Defina a propriedade Item para Form1 como SalesOrderTable.Selected.

   O Form1 mostra informações da linha selecionada no controle da tabela de dados .

   

Diretrizes de acessibilidade

Contraste de cores

Deve haver contraste de cores adequado entre:

• Cor e preenchimento
• HeadingColor e HeadingFill
• SelectedColor e SelectedFill
• HoverColor e HoverFill

Isso é além dos requisitos de contraste de cores padrão.

Suporte ao leitor de tela

• NoDataText deve estar presente.