Mostre um conjunto de dados em um formato tabular.

Descrição

O controle Tabela de dados mostra um conjunto de dados em um formato que inclui os cabeçalhos de coluna de cada campo mostrado pelo controle. Como criador de aplicativos, você tem controle total sobre quais campos aparecem e em qual ordem. O controle Tabela de dados mantém uma propriedade Selected que, assim como o controle Galeria, aponta para a única linha selecionada pelo usuário. Portanto, você pode vincular o controle Tabela de dados a outros controles.

Capacidades

O PowerApps introduziu o controle Tabela de dados 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.

Agora disponível

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

Ainda não disponível

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

Problemas conhecidos

  • Nenhum dado será exibido se a função FirstN for usada na propriedade Items.
  • Se a propriedade Items for modificada, a lista de campos será redefinida.
  • Em alguns conectores, a conexão à fonte de dados será perdida se a propriedade Items for modificada.

Propriedades-chave

  • Itens – a fonte de dados que aparece no controle Tabela de dados.
  • Selected – a linha selecionada no controle Tabela de dados.

Outras propriedades

  • BorderColor – a cor da borda do controle Tabela de dados.
  • BorderStyle – o estilo da borda do controle Tabela de dados. As opções são Solid, Dashed, Dotted e None.
  • BorderThickness – a espessura da borda do controle Tabela de dados.
  • Color – a cor de texto padrão de todas as linhas de dados.
  • 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 Tabela de dados.
  • 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.
  • NoDataText – A mensagem recebida pelo usuário quando não há registros para mostrar no controle Tabela de dados.
  • 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.
  • Visible – um valor que determina se o controle Tabela de dados é exibido ou é oculto.
  • Width – a distância entre as bordas esquerda e direita do controle Tabela de dados.
  • X – a distância entre a borda esquerda do controle Tabela de dados 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 Tabela de dados 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

Exemplos

Uso básico

  1. Crie um aplicativo de tablet em branco.

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

    Adicionar um controle Tabela de dados a uma tela

    Um controle Tabela de dados é adicionado à tela.

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

  4. No painel direito, clique ou toque na seta para baixo à direita de Nenhuma fonte de dados selecionada e, em seguida, clique ou toque em Adicionar uma fonte de dados.

    Adicionar uma fonte de dados

  5. Na lista de conexões, clique ou toque na conexão do banco de dados do Common Data Service.

    Selecionar a conexão da fonte de dados

  6. Na lista de entidades, clique ou toque em Ordem de venda e, em seguida, clique ou toque em Conectar.

    Selecionar a entidade Ordem de vendas

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

    Tabela de dados

  7. 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.

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

    Reorganizar os campos conforme desejado

    O controle SalesOrderTable mostra os campos na ordem especificada.

    Tabela de dados atualizada

Mude o estilo do cabeçalho do controle Tabela de dados

  1. Com o controle Tabela de dados 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 White.

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

    Tabela de dados

Conectar um controle Tabela de dados a outro controle

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

  2. Redimensione os controles Tabela de dados e Editar formulário de forma que o controle Tabela de dados seja exibido na parte esquerda da tela e o controle Editar formulário seja exibido na parte direita da tela.

    Tabela de dados e Editar formulário na mesma tela

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

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

    Vários campos inicias aparecerão no Form1.

    Form1 com campos inicias

  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 Tabela de dados.

    Editar formulário conectado à Tabela de dados