Class DataTableBuilder

DataTableBuilder

Построитель объектов DataTable. Построение таблицы данных состоит из сначала указания ее столбцов, а затем добавления строк по одной. Пример:

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

Методы

Метод Тип возврата Краткое описание
addColumn(type, label) DataTableBuilder Добавляет столбец в таблицу данных.
addRow(values) DataTableBuilder Добавляет строку в таблицу данных.
build() DataTable Строит и возвращает таблицу данных.
setValue(row, column, value) DataTableBuilder Устанавливает определенное значение в таблице.

Подробная документация

addColumn(type, label)

Добавляет столбец в таблицу данных. Столбцы будут добавлены от 0 до n.

Первый столбец часто используется на диаграммах для меток (например, меток оси X на линейных диаграммах или меток срезов на круговых диаграммах). Остальные столбцы часто используются для данных и поэтому часто требуют числовых значений.

Параметры

Имя Тип Описание
type ColumnType тип данных в столбце (число, строка или дата)
label String метка столбца (используется для легенд диаграмм).

Возвращаться

DataTableBuilder — это конструктор для создания цепочек.


addRow(values)

Добавляет строку в таблицу данных.

Параметры

Имя Тип Описание
values Object[] значения для строки, указанные в том же порядке, в котором вводятся столбцы.

Возвращаться

DataTableBuilder — это конструктор для создания цепочек.


build()

Строит и возвращает таблицу данных.

Возвращаться

DataTable — таблица данных

Броски

Error — если таблица данных пуста или иным образом искажена.


setValue(row, column, value)

Устанавливает определенное значение в таблице.

Вы можете установить значение перед добавлением столбца в таблицу данных. Однако, если столбец не будет добавлен в какой-то момент, значение будет игнорироваться.

Не все значения столбцов необходимо заполнять. Отсутствующие значения будут считаться null .

Параметры

Имя Тип Описание
row Integer индекс строки (первая строка имеет индекс 0)
column Integer индекс столбца (первый столбец имеет индекс 0)
value Object значение ячейки таблицы (должно иметь правильный тип для столбца).

Возвращаться

DataTableBuilder — этот конструктор для создания цепочек