Controle Tabela de dados no PowerAppsData table control in PowerApps

Mostre um conjunto de dados em um formato tabular.Shows a set of data in a tabular format.

DescriçãoDescription

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.The Data table control shows a dataset in a format that includes column headers for each field that the control shows. Como criador de aplicativos, você tem controle total sobre quais campos aparecem e em qual ordem.As an app maker, you have full control over which fields appear and in what order. 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.Like the Gallery control, the Data table control maintains a Selected property that points to the selected row. Portanto, você pode vincular o controle Tabela de dados a outros controles.Therefore, you can link the Data table control to other controls.

CapacidadesCapabilities

O PowerApps introduziu o controle Tabela de dados em 5 de maio de 2017.PowerApps introduced the Data table control on May 5, 2017. Esta seção fornece informações sobre as funcionalidades que têm suporte e as que não têm.This section provides information about capabilities that are supported and capabilities that aren't supported.

Agora disponívelNow available

  • Os dados em um controle Tabela de dados são de somente leitura.Data in a Data table control is read-only.
  • Uma única linha sempre é selecionada em um controle Tabela de dados.A single row is always selected in a Data table control.
  • Vincule um controle Tabela de dados a uma fonte de dados conectada ou local.Link a Data table control to a connected or local data source.
  • Ajuste as larguras das colunas em um controle Tabela de dados enquanto o aplicativo é executado, ainda que suas alterações não sejam salvas.Adjust column widths in a Data table control while you run the app, though your changes aren't saved.
  • 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.A set of default fields appear in a Data table control when you link it to a connector that has implemented this capability, such as the Common Data Service. Então, será possível mostrar ou ocultar esses campos e outros, conforme necessário.You can then show or hide these fields and others as necessary.
  • Personalize a largura da coluna e o texto do cabeçalho.Customize column width and heading text.
  • Mostre hiperlinks em um controle de Tabela de dados.Show hyperlinks in a Data table control.
  • Copie e cole um controle de Tabela de dados.Copy and paste a Data table control.

Ainda não disponívelNot yet available

  • Personalize o estilo de colunas individuais.Customize the styling of individual columns.
  • Adicione um controle Tabela de dados a um controle de formulário.Add a Data table control in a form control.
  • Alterar a altura de todas as linhas.Change the height of all rows.
  • Mostrar imagens em um controle Tabela de dados.Show images in a Data table control.
  • Mostrar campos de entidades relacionadas.Show fields from related entities.
  • Use a funcionalidade interna para filtrar e classificar dados por título de coluna.Use built-in functionality to filter and sort data by column heading.
  • Adicione um controle Tabela de dados a um controle Galeria.Add a Data table control in a Gallery control.
  • Edite dados no controle Tabela de dados.Edit data in the Data table control.
  • Selecione várias linhas.Select multiple rows.

Problemas conhecidosKnown issues

  • Nenhum dado será exibido se a função FirstN for usada na propriedade Items.No data appears if you use the FirstN function in the Items property.

Propriedades-chaveKey properties

  • Itens – a fonte de dados que aparece no controle Tabela de dados.Items – The source of data that appears in the Data table control.
  • Selected – a linha selecionada no controle Tabela de dados.Selected – The selected row in the Data table control.

Outras propriedadesOther properties

  • BorderColor – a cor da borda do controle Tabela de dados.BorderColor – The color of the Data table control's border.
  • BorderStyle – o estilo da borda do controle Tabela de dados.BorderStyle – The style of the Data table control's border. As opções são Solid, Dashed, Dotted e None.The options are Solid, Dashed, Dotted, and None.
  • BorderThickness – a espessura da borda do controle Tabela de dados.BorderThickness – The thickness of the Data table control's border.
  • Color – a cor de texto padrão de todas as linhas de dados.Color – The default text color for all data rows.
  • Fill – a cor da tela de fundo padrão de todas as linhas de dados.Fill – The default background color for all data rows.
  • Font – a fonte padrão para todas as linhas de dados.Font - The default font for all data rows.
  • FontWeight – a espessura de fonte padrão de todas as linhas de dados.FontWeight – The default font weight for all data rows.
  • HeadingColor – a cor do texto dos cabeçalhos de coluna.HeadingColor – The text color for the column headings.
  • HeadingFill – a cor da tela de fundo dos cabeçalhos de coluna.HeadingFill – The background color of the column headings.
  • HeadingFont – a fonte dos cabeçalhos de coluna.HeadingFont – The font of the column headings.
  • HeadingFontWeight – a espessura da fonte dos cabeçalhos de coluna.HeadingFontWeight – The font weight of the column headings.
  • HeadingSize – o tamanho da fonte dos cabeçalhos de coluna.HeadingSize – The font size of the column headings.
  • Height – a distância entre as bordas superior e inferior do controle Tabela de dados.Height – The distance between the Data table control's top and bottom edges.
  • HoverColor – a cor do texto da linha para a qual o ponteiro do mouse está apontando.HoverColor – The text color for the row that the mouse pointer is pointing at.
  • HoverFill – a cor da tela de fundo da linha para a qual o ponteiro do mouse está apontando.HoverFill – The background color of the row that the mouse pointer is pointing at.
  • NoDataText – A mensagem recebida pelo usuário quando não há registros para mostrar no controle Tabela de dados.NoDataText – The message that the user receives when there are no records to show in the Data table control.
  • SelectedColor – a cor do texto na linha selecionada.SelectedColor – The color of the text in the selected row.
  • SelectedFill – a cor da tela de fundo da linha selecionada.SelectedFill – The background color of the selected row.
  • Size – o tamanho da fonte padrão de todas as linhas de dados.Size – The default font size for all data rows.
  • Visible – um valor que determina se o controle Tabela de dados é exibido ou é oculto.Visible – A value that determines whether the Data table control appears or is hidden.
  • Width – a distância entre as bordas esquerda e direita do controle Tabela de dados.Width – The distance between the Data table control's left and right edges.
  • 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).X – The distance between the left edge of the Data table control and the left edge of its parent container (or the left edge of the screen if there is no parent container).
  • 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).Y – The distance between the top edge of the Data table control and the top edge of its parent container (or the top edge of the screen if there is no parent container).

ExemplosExamples

Uso básicoBasic usage

  1. Crie um aplicativo de tablet em branco.Create a blank tablet app.
  2. Na guia Inserir, clique ou toque em Tabela de dados.On the Insert tab, click or tap Data table.

    Adicionar um controle Tabela de dados a uma tela

    Um controle Tabela de dados é adicionado à tela.A Data table control is added to the screen.

  3. Renomeie o SalesOrderTable do controle Tabela de dados e redimensione-o de forma que ele abranja a tela inteira.Rename the Data table control SalesOrderTable, and resize it so that it covers the whole screen.
  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.In the right pane, click or tap the down arrow to the right of the No data source selected text, and then click or tap Add a data source.

    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.In the list of connections, click or tap the connection for your Common Data Service database.

    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.In the list of entities, click or tap Sales order, and then click or tap Connect.

    Selecionar a entidade Ordem de vendas

    Agora, o controle Tabela de dados está anexado à fonte de dados Ordem de venda.The Data table control is now attached to the Sales order data source. Vários campos iniciais aparecem no controle Tabela de dados, pois estamos usando um conector que dá suporte a essa funcionalidade.Several initial fields appear in the Data table control, because we're using a connector that supports that capability.

    Tabela de dados

  7. No painel direito, selecione uma ou mais caixas de seleção para mostrar ou ocultar campos individuais.In the right pane, select one or more check boxes to show or hide individual fields.

    Por exemplo, selecione a caixa de seleção ao lado de CustomerPurchaseOrderReference para ocultar esse campo.For example, select the check box next to CustomerPurchaseOrderReference to hide this field.

  8. No painel direito, reorganize os campos arrastando-os para cima ou para baixo.In the right pane, reorder the fields by dragging them up or down.

    Reorganizar os campos conforme desejado

    O controle SalesOrderTable mostra os campos na ordem especificada.The SalesOrderTable control shows the fields in the order that you specified.

    Tabela de dados atualizada

Mude o estilo do cabeçalho do controle Tabela de dadosRestyle the header for the Data table control

  1. Com o controle Tabela de dados selecionado, clique ou toque na guia Avançado do painel direito.While the Data table control is selected, in the right pane, click or tap the Advanced tab.
  2. Clique ou toque no campo da propriedade HeadingFill e, em seguida, altere o valor para RGBA(62,96,170,1).Click or tap the field for the HeadingFill property, and then change the value to RGBA(62,96,170,1).
  3. Clique ou toque no campo da propriedade HeadingColor e altere o valor para White.Click or tap the field for the HeadingColor property, and then change the value to White.
  4. Clique ou toque no campo da propriedade HeadingSize e, em seguida, altere o valor para 14.Click or tap the field for the HeadingSize property, and then change the value to 14.

    Tabela de dados

Conectar um controle Tabela de dados a outro controleConnect a Data table control to another control

  1. Adicione um controle Editar formulário à tela.Add an Edit form control to the screen.
  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.Resize the Data table and Edit form controls so that the Data table control appears in the left part of the screen and the Edit form control appears in the right part of the screen.

    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.While Form1 is selected, in the right pane, change the number of columns to 1.
  4. Conecte Form1 à fonte de dados Ordem de venda.Connect Form1 to the Sales order data source.

    Vários campos inicias aparecerão no Form1.Several initial fields appear in Form1.

    Form1 com campos inicias

  5. No painel direito, clique ou toque na guia Avançado.In the right pane, click or tap the Advanced tab.
  6. Defina a propriedade Item do Form1 como SalesOrderTable.Selected.Set the Item property for Form1 to SalesOrderTable.Selected.

    Form1 mostra informações da linha selecionada no controle Tabela de dados.Form1 shows information from the row that's selected in the Data table control.

    Editar formulário conectado à Tabela de dados