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)
setValue(row, column, value)
設定資料表中的特定值。
您可以先設定值,再將資料欄加入資料表。然而,除非在某個時間點新增資料欄,否則系統會忽略該值。
部分資料欄的值不一定要填寫。缺少的項目會視為「null
」。
參數
名稱 | 類型 | 說明 |
---|---|---|
row | Integer | 列索引 (第一列的索引為 0) |
column | Integer | 欄索引 (第一欄的索引為 0) |
value | Object | 表格儲存格的值 (必須為欄的類型)。 |
回攻員
DataTableBuilder
:這個建構工具用於鏈結