Builder von DataTable-Objekten. Beim Erstellen einer Datentabelle werden zuerst die Spalten angegeben und die Zeilen werden nacheinander hinzugefügt. Beispiel:
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();
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. Es werden Spalten von 0 bis n hinzugefügt.
Die erste Spalte wird häufig von Diagrammen für Beschriftungen verwendet (z. B. Labels der X-Achse in Liniendiagrammen oder Segmentbeschriftungen 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 in der Spalte (Zahl, String oder Datum) |
label | String | Beschriftung der Spalte, die für Diagrammlegenden verwendet wird. |
Return
DataTableBuilder
: Dieser Builder zum Verketten.
addRow(values)
Fügt der Datentabelle eine Zeile hinzu.
Parameter
Name | Typ | Beschreibung |
---|---|---|
values | Object[] | Werte für die Zeile, die in der Reihenfolge angegeben werden, in der die Spalten eingegeben werden. |
Return
DataTableBuilder
: Dieser Builder zum Verketten.
build()
setValue(row, column, value)
Legt einen bestimmten Wert in der Tabelle fest.
Sie können einen Wert festlegen, bevor Sie die Spalte zur Datentabelle hinzufügen. Wenn die Spalte jedoch nicht irgendwann hinzugefügt wird, wird der Wert ignoriert.
Nicht alle Spaltenwerte müssen ausgefüllt werden. Die fehlenden werden als null
eingestuft.
Parameter
Name | Typ | Beschreibung |
---|---|---|
row | Integer | Zeilenindex (die erste Zeile hat Index 0) |
column | Integer | Spaltenindex (die erste Spalte hat Index 0) |
value | Object | den Wert der Tabellenzelle (sollte den richtigen Typ für die Spalte haben) |
Return
DataTableBuilder
– dieser Builder zum Verketten