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 軸標籤，或圓餅圖中的切片標籤)。其他資料欄經常用於資料，因此通常需要數值。

參數

名稱類型說明
typeColumnType資料欄中的資料類型 (數字、字串或日期)
labelString資料欄的標籤 (用於圖表圖例)。

回攻員

DataTableBuilder — 這個建構工具用於鏈結。

addRow(values)

在資料表中新增一列。

參數

名稱類型說明
valuesObject[]資料列的值，按照輸入資料欄的順序指定。

回攻員

DataTableBuilder — 這個建構工具用於鏈結。

build()

建構並傳回資料表。

回攻員

DataTable：資料表

擲回

Error：如果資料表空白或有其他格式錯誤

setValue(row, column, value)

設定資料表中的特定值。

您可以先設定值，再將資料欄加入資料表。然而，除非在某個時間點新增資料欄，否則系統會忽略該值。

部分資料欄的值不一定要填寫。缺少的項目會視為「null」。

參數

名稱類型說明
rowInteger列索引 (第一列的索引為 0)
columnInteger欄索引 (第一欄的索引為 0)
valueObject表格儲存格的值 (必須為欄的類型)。

回攻員

DataTableBuilder：這個建構工具用於鏈結