Controle Data table no Power Apps

Mostra um conjunto de dados em um formato tabular.

Descrição

O controle Data table mostra um conjunto de dados em um formato que inclui os cabeçalhos de coluna de cada campo mostrado pelo controle. Como criador de apps, você tem controle total sobre quais campos são exibidos e sua ordem de exibição. Como o controle Gallery, o controle Data table mantém uma propriedade Selected, que aponta para a linha selecionada. Portanto, você pode vincular o controle Data table a outros controles.

Recursos

O Power Apps apresentou o controle Data table em 5 de maio de 2017. Esta seção fornece informações sobre as funcionalidades que têm suporte e as que não têm.

Já disponível

• Os dados em um controle Data table são de somente leitura.
• Uma única linha sempre é selecionada em um controle Data table.
• Vincular um controle Data table a uma fonte de dados conectada ou local.
• Ajustar as larguras das colunas em um controle Data table enquanto o aplicativo é executado, embora suas alterações não sejam salvas.
• Um conjunto de campos padrão é exibido em um controle Data table quando ele é vinculado a um conector que implementou essa funcionalidade, como o Microsoft Dataverse. Então, será possível mostrar ou ocultar esses campos e outros, conforme necessário.
• Personalizar a largura da coluna e o texto do cabeçalho.
• Mostrar hiperlinks em um controle Data table.
• Copiar e colar um controle Data table.

Ainda não disponível

• Personalizar o estilo de colunas individuais.
• Adicionar um controle Data table a um controle de formulário.
• Alterar a altura de todas as linhas.
• Mostrar imagens em um controle Data table.
• Mostre campos de tabelas relacionadas.
• Usar a funcionalidade interna para filtrar e classificar dados por título de coluna.
• Adicionar um controle Data table a um controle Gallery.
• Editar dados no controle Data table.
• Selecionar várias linhas.

Problemas conhecidos

• Nenhum dado será exibido se a função FirstN for usada na propriedade Items.

Propriedades-chave

• Items – a fonte de dados que aparece no controle Data table.
• Selected – a linha selecionada no controle Data table.

Outras propriedades

• AutoWidth - A propriedade de uma coluna dentro de uma tabela de dados para definir se a largura da coluna deve ser automática ou manual.
• BorderColor – a cor da borda do controle Data table.
• BorderStyle – o estilo da borda do controle Data table. As opções são Solid, Dashed, Dotted e None.
• BorderThickness – a espessura da borda do controle Data table.
• Color – a cor de texto padrão de 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.
• Fill – a cor da tela de fundo padrão de todas as linhas de dados.
• Font – a fonte padrão para todas as linhas de dados.
• FontWeight – a espessura de fonte padrão de todas as linhas de dados.
• HeadingColor – a cor do texto dos cabeçalhos de coluna.
• HeadingFill – a cor da tela de fundo dos cabeçalhos de coluna.
• HeadingFont – a fonte dos cabeçalhos de coluna.
• HeadingFontWeight – a espessura da fonte dos cabeçalhos de coluna.
• HeadingSize – o tamanho da fonte dos cabeçalhos de coluna.
• Height – a distância entre as bordas superior e inferior do controle Data table.
• HoverColor – a cor do texto da linha para a qual o ponteiro do mouse está apontando.
• HoverFill – a cor da tela de fundo da linha para a qual 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 em formato de hiperlink ou não.
• NoDataText – a mensagem recebida pelo usuário quando não há registros para mostrar no controle Data table.
• Order - A propriedade de uma coluna dentro de uma tabela de dados que determina a ordem da coluna em relação às outras colunas. A ordem começa da esquerda para a direita com o valor 1 da ordem da primeira coluna.
• SelectedColor – a cor do texto na linha selecionada.
• SelectedFill – a cor da tela de fundo da linha selecionada.
• Size – o tamanho da fonte padrão de todas as linhas de dados.
• Text - A propriedade de uma coluna dentro de uma tabela de dados que define o valor do texto dos dados a serem exibidos dentro da coluna selecionada.
• Visible – um valor que determina se o controle Data table é exibido ou é oculto.
• Width – a distância entre as bordas esquerda e direita do controle Data table.
• X – a distância entre a borda esquerda do controle Data table e a borda esquerda de seu contêiner pai (ou a borda esquerda da tela, caso não haja nenhum contêiner pai).
• Y – a distância entre a borda superior do controle Data table e a borda superior de seu contêiner pai (ou a borda superior da tela, caso não haja 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 de tablet em branco.

2. Na guia Inserir, clique ou toque em Tabela de dados.

   

   Um controle Data table é adicionado à tela.

3. Renomeie o SalesOrderTable do controle Data table e redimensione-o de forma que ele abranja a tela inteira.

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

   

   Agora, o controle Data table está anexado à fonte de dados Pedido de venda. Vários campos iniciais aparecem no controle Data table, pois estamos usando um conector que dá suporte a essa funcionalidade.

   

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

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

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

   

   O controle SalesOrderTable mostra os campos na ordem especificada.

   

Mude o estilo do cabeçalho do controle Data table

1. Com o controle Data table selecionado, clique ou toque na guia Avançado do painel direito.

2. Clique ou toque no campo da propriedade HeadingFill e, em seguida, 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, em seguida, altere o valor para 14.

   

Conectar um controle Data table a outro controle

1. Adicione um controle Edit form à tela.

2. Redimensione os controles Data table e Edit form de forma que o controle Data table seja exibido na parte esquerda da tela e o controle Edit form seja exibido na parte direita da tela.

   

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

4. Conecte Form1 à fonte de dados Pedido de venda.

   Vários campos inicias aparecerão no Form1.

   

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

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

   Form1 mostra informações da linha selecionada no controle Data table.

   

Diretrizes de acessibilidade

Contraste de cores

É necessário haver um contraste de cores adequado entre:

• Color e Fill
• HeadingColor e HeadingFill
• SelectedColor e SelectedFill
• HoverColor e HoverFill

Isso é adicional aos requisitos de contraste de cores padrão.

Suporte ao leitor de tela

• NoDataText precisa estar presente.

Observação

Você pode nos falar mais sobre suas preferências de idioma para documentação? Faça uma pesquisa rápida. (Observe que esta pesquisa está em inglês)

A pesquisa levará cerca de sete minutos. Nenhum dado pessoal é coletado (política de privacidade).