Esta página foi traduzida pela API Cloud Translation.

Class DataTableBuilder

Builder de objetos DataTable. Criar uma tabela de dados consiste em primeiro especificar as colunas e depois adicionar as linhas, uma de cada vez. Exemplos

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

Retorno

DataTableBuilder: este builder, para encadeamento.

`addRow(values)`

Adiciona uma linha à tabela de dados.

Parâmetros

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

Retorno

DataTableBuilder: este builder, para encadeamento.

`build()`

Cria e retorna uma tabela de dados.

Retorno

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 seja adicionada 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 certo para a coluna).

Retorno

DataTableBuilder: este builder, para encadeamento