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：這個建構工具用於鏈結