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 suas colunas e e, em seguida, adicionando as linhas, uma de cada vez. Exemplo:

var 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 é frequentemente usada por gráficos para rótulos (por exemplo, rótulos do eixo X em linhas gráficos ou rótulos de fatias em gráficos de pizza). As outras colunas costumam ser usadas 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 para legendas de gráficos).

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 malformada

`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 for adicionado em algum momento, o valor será ignorado.

Nem todos os valores das colunas precisam ser preenchidos. Aqueles ausentes serão considerados null.

Parâmetros

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

Retornar

DataTableBuilder: este builder para encadeamento