Class DataTableBuilder

DataTableBuilder

Konstruktor obiektów DataTable. Aby utworzyć tabelę danych, trzeba najpierw określić kolumny, a potem dodać kolejne wiersze. Przykład:

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

Metody

Metoda	Zwracany typ	Krótki opis
addColumn(type, label)	DataTableBuilder	Dodaje kolumnę do tabeli danych.
addRow(values)	DataTableBuilder	Dodaje wiersz do tabeli danych.
build()	DataTable	Kompiluje i zwraca tabelę danych.
setValue(row, column, value)	DataTableBuilder	Ustawia określoną wartość w tabeli.

Szczegółowa dokumentacja

addColumn(type, label)

Dodaje kolumnę do tabeli danych. Kolumny zostaną dodane od 0 do n.

Pierwsza kolumna jest często używana na wykresach z etykietami (np. etykiety osi X na wykresach liniowych lub etykiety wycinków na wykresach kołowych). Inne kolumny są często używane do podawania danych i dlatego często wymagają wartości liczbowych.

Parametry

Nazwa	Typ	Opis
type	ColumnType	typ danych w kolumnie (liczba, ciąg znaków lub data);
label	String	etykieta kolumny (jest używana w legendach wykresu).

Powroty

DataTableBuilder – ten kreator do tworzenia łańcuchów.

---

addRow(values)

Dodaje wiersz do tabeli danych.

Parametry

Nazwa	Typ	Opis
values	Object[]	określone w tej samej kolejności co kolumny.

Powroty

DataTableBuilder – ten kreator do tworzenia łańcuchów.

---

build()

Kompiluje i zwraca tabelę danych.

Powroty

DataTable – tabela danych,

Rzuty

Error – jeśli tabela danych jest pusta lub ma nieprawidłowy format

---

setValue(row, column, value)

Ustawia określoną wartość w tabeli.

Przed dodaniem kolumny do tabeli danych można ustawić wartość. Jeśli jednak kolumna nie zostanie w którym momencie dodana, wartość będzie ignorowana.

Nie wszystkie wartości kolumn muszą być wypełnione. Brakujące dane będą traktowane jako null.

Parametry

Nazwa	Typ	Opis
row	Integer	indeks wiersza (pierwszy wiersz ma indeks 0)
column	Integer	indeks kolumny (pierwsza kolumna ma indeks 0)
value	Object	wartość komórki tabeli (powinna mieć właściwy typ dla kolumny).

Powroty

DataTableBuilder – ten kreator do tworzenia łańcuchów