类: TableManager

Sheets.Tables.TableManager

Table of contents

构造方法

• constructor

方法

• add
• addFromDataSource
• all
• find
• findByName
• move
• remove
• resize

构造方法

constructor

• new TableManager(sheet)

可以管理表单中所有表格的表管理器

参数

属性名	类型	说明
sheet	Worksheet	表单

方法

add

▸ add(name?, row?, column?, rowCount?, columnCount?, style?): Table

将具有指定大小的区域表添加到表单

代码示例

//本示例添加一个表格
activeSheet.tables.add("Table1", 0, 0, 3, 3, GC.Spread.Sheets.Tables.TableThemes.dark1);
activeSheet.getCell(0,0).text("Name");
activeSheet.getCell(0,1).text("Value");
activeSheet.getCell(0,2).text("T/F");
activeSheet.getCell(1,0).text("AW");
activeSheet.getCell(1,1).text("5");
activeSheet.getCell(1,2).text("T");

参数

属性名	类型	说明
name?	string	表格名称
row?	number	行索引
column?	number	列索引
rowCount?	number	表格行数
columnCount?	number	表格列数
style?	TableTheme	表格样式

返回值

Table

新表实例

---

addFromDataSource

▸ addFromDataSource(name, row, column, dataSource, style): Table

将具有指定数据源的区域表添加到表单

代码示例

var source = [
                { LastName: "Freehafer", FirstName: "Nancy", Title: "Sales Representative", Phone: "(123)555-0100"},
                { LastName: "Cencini", FirstName: "Andrew", Title: "Vice President, Sales", Phone: "(123)555-0101"},
                { LastName: "Kotas", FirstName: "Jan", Title: "Sales Representative", Phone: "(123)555-0102"},
                { LastName: "Sergienko", FirstName: "Mariya", Title: "Sales Representative", Phone: "(123)555-0103"},
            ];
 activeSheet.tables.addFromDataSource("Table1", 5, 2, source, GC.Spread.Sheets.Tables.TableThemes.dark1);

参数

属性名	类型	说明
name	string	表格名称
row	number	行索引
column	number	列索引
dataSource	Object	表格的数据源
style	TableTheme	表格样式
options?	ITableOptions	-

返回值

Table

新表实例

---

all

▸ all(): Table[]

获取表单的所有表格

返回值

Table[]

GC.Spread.Sheets.Tables.Table 表格数组实例.数组不为null

---

find

▸ find(row, column): Table

获取指定单元格的表

代码示例

//本示例使用find方法
activeSheet.tables.add("Table1", 0, 0, 3, 3, GC.Spread.Sheets.Tables.TableThemes.dark1);
activeSheet.getCell(0,0).text("Name");
activeSheet.getCell(0,1).text("Value");
activeSheet.getCell(0,2).text("T/F");
activeSheet.getCell(1,0).text("AW");
activeSheet.getCell(1,1).text("5");
activeSheet.getCell(1,2).text("T");
//点击按钮
$("#button1").click(function () {
     var table  = activeSheet.tables.find(0,0);
     console.log(table.name());
});

参数

属性名	类型	说明
row	number	行索引
column	number	列索引

返回值

Table

如果单元格属于一个表，返回表实例；否则返回null

---

findByName

▸ findByName(name): Table

获取具有指定名称的表格

代码示例

//本示例按名称查找表
var activeSheet = spread.getActiveSheet();
activeSheet.tables.add("Table1", 0, 0, 3, 3, GC.Spread.Sheets.Tables.TableThemes.dark1);
activeSheet.getCell(0,0).text("Name");
activeSheet.getCell(0,1).text("Value");
activeSheet.getCell(0,2).text("T/F");
activeSheet.getCell(1,0).text("AW");
activeSheet.getCell(1,1).text("5");
activeSheet.getCell(1,2).text("T");
// button click
$("#button1").click(function () {
     var table  = activeSheet.tables.findByName("Table1");
     console.log(table.name());
});

参数

属性名	类型	说明
name	string	The table name.

返回值

Table

The table instance if the cell belongs to a table; otherwise, null.

---

move

▸ move(table, row, column): void

Changes the table location.

代码示例

var activeSheet = spread.getActiveSheet();
activeSheet.tables.add("Table1", 0, 0, 3, 3, GC.Spread.Sheets.Tables.TableThemes.dark1);
activeSheet.getCell(0,0).text("Name");
activeSheet.getCell(0,1).text("Value");
activeSheet.getCell(0,2).text("T/F");
activeSheet.getCell(1,0).text("AW");
activeSheet.getCell(1,1).text("5");
activeSheet.getCell(1,2).text("T");
// button click
$("#button1").click(function () {
     var table  = activeSheet.tables.findByName("Table1");
     alert(table);
     activeSheet.tables.move(table, 3, 3);
});

参数

属性名	类型	说明
table	string | Table	The table instance or the table name.
row	number	The new row index.
column	number	The new column index.

返回值

void

---

remove

▸ remove(table, options): Table

删除指定的表

代码示例

var table  = activeSheet.tables.find(0,0);
activeSheet.tables.remove(table, GC.Spread.Sheets.Tables.TableRemoveOptions.keepData);

参数

属性名	类型	说明
table	string | 表实例或表名称
options	TableRemoveOptions	删除表时保留哪些数据

返回值

Table

---

resize

▸ resize(table, range): void

更改表格大小

代码示例

//本示例调整表的大小
activeSheet.tables.add("Table1", 0, 0, 3, 3, GC.Spread.Sheets.Tables.TableThemes.dark1);
activeSheet.getCell(0,0).text("Name");
activeSheet.getCell(0,1).text("Value");
activeSheet.getCell(0,2).text("T/F");
activeSheet.getCell(1,0).text("AW");
activeSheet.getCell(1,1).text("5");
activeSheet.getCell(1,2).text("T");
//点击按钮
$("#button1").click(function () {
     var table  = activeSheet.tables.find(0,0);
     activeSheet.tables.resize(table, new GC.Spread.Sheets.Range(0,0,4,4));
});

参数

属性名	类型	说明
table	string | Table	表格或表格名
range	Range	新表区域 页眉必须保留在同一行中，并且新表区域必须与原始表区域重叠

返回值

void