Class DataTableBuilder

DataTableBuilder

Builder di oggetti DataTable. Per creare una tabella di dati, devi innanzitutto specificarne le colonne e e aggiungendone le righe, una alla volta. Esempio:

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();

Metodi

MetodoTipo restituitoBreve descrizione
addColumn(type, label)DataTableBuilderAggiunge una colonna alla tabella di dati.
addRow(values)DataTableBuilderAggiunge una riga alla tabella di dati.
build()DataTableCrea e restituisce una tabella di dati.
setValue(row, column, value)DataTableBuilderConsente di impostare un valore specifico nella tabella.

Documentazione dettagliata

addColumn(type, label)

Aggiunge una colonna alla tabella di dati. Le colonne verranno aggiunte da 0 a n.

La prima colonna viene spesso utilizzata dai grafici per le etichette (ad esempio, le etichette dell'asse X sulla linea grafici o le etichette delle sezioni nei grafici a torta). Le altre colonne vengono spesso utilizzate per i dati e, di conseguenza, spesso richiedono valori numerici.

Parametri

NomeTipoDescrizione
typeColumnTypetipo di dati nella colonna (numero, stringa o data)
labelStringdell'etichetta della colonna (utilizzata per le legende del grafico).

Invio

DataTableBuilder: questo builder, per il concatenamento.


addRow(values)

Aggiunge una riga alla tabella di dati.

Parametri

NomeTipoDescrizione
valuesObject[]per la riga, specificati nello stesso ordine in cui vengono inserite le colonne.

Invio

DataTableBuilder: questo builder, per il concatenamento.


build()

Crea e restituisce una tabella di dati.

Invio

DataTable: la tabella di dati

Lanci

Error: se la tabella di dati è vuota o in un formato diverso


setValue(row, column, value)

Consente di impostare un valore specifico nella tabella.

Puoi impostare un valore prima di aggiungere la colonna alla tabella di dati. Tuttavia, a meno che la colonna viene aggiunto a un certo punto, il valore verrà ignorato.

Non tutti i valori della colonna devono essere compilati. Quelli mancanti saranno considerati null.

Parametri

NomeTipoDescrizione
rowIntegerl'indice della riga (la prima riga ha indice 0)
columnIntegerl'indice della colonna (la prima colonna ha indice 0)
valueObjectil valore della cella della tabella (deve avere il tipo corretto per la colonna).

Invio

DataTableBuilder: questo builder, per il concatenamento