Esta página foi traduzida pela API Cloud Translation.

Class DataTableBuilder

Builder de objetos DataTable. A criação de uma tabela de dados consiste em primeiro especificar as colunas e, em seguida, adicionar as linhas, uma de cada vez. Exemplo:

const data = Charts.newDataTable()
                 .addColumn(Charts.ColumnType.STRING, 'Month')
                 .addColumn(Charts.ColumnType.NUMBER, 'In Store')
                 .addColumn(Charts.ColumnType.NUMBER, 'Online')
                 .addRow(['January', 10, 1])
                 .addRow(['February', 12, 1])
                 .addRow(['March', 20, 2])
                 .addRow(['April', 25, 3])
                 .addRow(['May', 30, 4])
                 .build();

Métodos

Método	Tipo de retorno	Breve descrição
`addColumn(type, label)`	`DataTableBuilder`	Adiciona uma coluna à tabela de dados.
`addRow(values)`	`DataTableBuilder`	Adiciona uma linha à tabela de dados.
`build()`	`DataTable`	Cria e retorna uma tabela de dados.
`setValue(row, column, value)`	`DataTableBuilder`	Define um valor específico na tabela.

Documentação detalhada

`addColumn(type, label)`

Adiciona uma coluna à tabela de dados. As colunas serão adicionadas de 0 a n.

A primeira coluna é usada com frequência por gráficos para rótulos (por exemplo, rótulos do eixo X em gráficos de linhas ou rótulos de fatia em gráficos de pizza). As outras colunas são usadas com frequência para dados e, portanto, muitas vezes exigem valores numéricos.

Parâmetros

Nome	Tipo	Descrição
`type`	`ColumnType`	tipo de dados na coluna (número, string ou data)
`label`	`String`	rótulo da coluna (usado nas legendas do gráfico).

Retornar

DataTableBuilder: este builder, para encadeamento.

`addRow(values)`

Adiciona uma linha à tabela de dados.

Parâmetros

Nome	Tipo	Descrição
`values`	`Object[]`	valores da linha, especificados na mesma ordem em que as colunas são inseridas.

Retornar

DataTableBuilder: este builder, para encadeamento.

`build()`

Cria e retorna uma tabela de dados.

Retornar

DataTable: a tabela de dados

Gera

Error: se a tabela de dados estiver vazia ou tiver um formato inválido.

`setValue(row, column, value)`

Define um valor específico na tabela.

É possível definir um valor antes de adicionar a coluna à tabela de dados. No entanto, a menos que a coluna seja adicionada em algum momento, o valor será ignorado.

Nem todos os valores de coluna precisam ser preenchidos. Os valores ausentes serão considerados null.

Parâmetros

Nome	Tipo	Descrição
`row`	`Integer`	o índice da linha (a primeira linha tem índice 0)
`column`	`Integer`	o índice da coluna (a primeira coluna tem índice 0)
`value`	`Object`	o valor da célula da tabela (precisa ter o tipo certo para a coluna).

Retornar

DataTableBuilder: este builder, para encadeamento