Class DataTableBuilder

DataTableBuilder

Kreator obiektów DataTable. Tworzenie tabeli danych polega na najpierw określeniu jej kolumn, a a potem dodawać wiersze pojedynczo. 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

MetodaZwracany typKrótki opis
addColumn(type, label)DataTableBuilderDodaje kolumnę do tabeli danych.
addRow(values)DataTableBuilderDodaje wiersz do tabeli danych.
build()DataTableTworzy i zwraca tabelę danych.
setValue(row, column, value)DataTableBuilderUstawia konkretną 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 jako etykiet (np. etykiety na osi X w wierszu wykresów ani etykiet wycinków na wykresach kołowych). Inne kolumny są często używane do wyświetlania danych, więc często wymagają wartości liczbowych.

Parametry

NazwaTypOpis
typeColumnTypetyp danych w kolumnie (liczba, ciąg znaków lub data)
labelStringetykieta kolumny (używana w legendach wykresu).

Powrót

DataTableBuilder – narzędzie do tworzenia łańcuchów.


addRow(values)

Dodaje wiersz do tabeli danych.

Parametry

NazwaTypOpis
valuesObject[]wartości w wierszu określonych w tej samej kolejności, w jakiej są wprowadzane kolumny.

Powrót

DataTableBuilder – narzędzie do tworzenia łańcuchów.


build()

Tworzy i zwraca tabelę danych.

Powrót

DataTable – tabela danych,

Rzuty

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


setValue(row, column, value)

Ustawia konkretną wartość w tabeli.

Przed dodaniem kolumny do tabeli danych możesz ustawić wartość. Jeśli jednak kolumna zostanie w którymś momencie dodany, wartość zostanie zignorowana.

Nie wszystkie wartości kolumn muszą być wypełnione. Te brakujące zostaną uznane za null.

Parametry

NazwaTypOpis
rowIntegerindeks wiersza (pierwszy wiersz ma indeks 0),
columnIntegerindeks kolumny (pierwsza kolumna ma indeks 0),
valueObjectwartość komórki tabeli (powinna mieć odpowiedni typ dla kolumny).

Powrót

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