Class DataTableBuilder

DataTableBuilder

Builder für DataTable-Objekte. Um eine Datentabelle zu erstellen, müssen Sie zuerst die Spalten und dann die Zeilen hinzufügen. Beispiel:

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

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
addColumn(type, label)	DataTableBuilder	Fügt der Datentabelle eine Spalte hinzu.
addRow(values)	DataTableBuilder	Fügt der Datentabelle eine Zeile hinzu.
build()	DataTable	Erstellt eine Datentabelle und gibt sie zurück.
setValue(row, column, value)	DataTableBuilder	Legt einen bestimmten Wert in der Tabelle fest.

Detaillierte Dokumentation

addColumn(type, label)

Fügt der Datentabelle eine Spalte hinzu. Spalten werden von 0 bis n hinzugefügt.

Die erste Spalte wird häufig für Labels in Diagrammen verwendet, z. B. für X-Achsenlabels in Liniendiagrammen oder Segmentlabels in Kreisdiagrammen. Die anderen Spalten werden häufig für Daten verwendet und erfordern daher oft numerische Werte.

Parameter

Name	Typ	Beschreibung
type	ColumnType	Datentyp der Spalte (Zahl, String oder Datum)
label	String	Label der Spalte (wird für Diagrammlegenden verwendet).

Rückflug

DataTableBuilder – dieser Builder zur Verkettung.

---

addRow(values)

Fügt der Datentabelle eine Zeile hinzu.

Parameter

Name	Typ	Beschreibung
values	Object[]	Werte für die Zeile, in derselben Reihenfolge wie die Spalten.

Rückflug

DataTableBuilder – dieser Builder zur Verkettung.

---

build()

Erstellt eine Datentabelle und gibt sie zurück.

Rückflug

DataTable – die Datentabelle

Löst

Error: wenn die Datentabelle leer oder anderweitig fehlerhaft ist

---

setValue(row, column, value)

Legt einen bestimmten Wert in der Tabelle fest.

Sie können einen Wert festlegen, bevor Sie die Spalte der Datentabelle hinzufügen. Wenn die Spalte jedoch nicht irgendwann hinzugefügt wird, wird der Wert ignoriert.

Nicht alle Spaltenwerte müssen ausgefüllt werden. Fehlende Werte werden als null betrachtet.

Parameter

Name	Typ	Beschreibung
row	Integer	Der Zeilenindex (die erste Zeile hat den Index 0)
column	Integer	der Spaltenindex (die erste Spalte hat den Index 0)
value	Object	Der Wert der Tabellenzelle muss den richtigen Typ für die Spalte haben.

Rückflug

DataTableBuilder – dieser Builder zur Verkettung