Tables

Tables

JSSDK: 1.3.0、zOffice V6 支持

文档中所有表格对象的集合

属性

count

表格数量。

语法

Tables.count

返回值

Promise<number>

示例

async function example() {
  const count = await Application.ActiveDocument.Tables.count;
}

方法

add

在当前选区或者指定区域插入一个空白表格，表格将替换该区域。

语法

Tables.add(rowNum, columnNum, option)

参数

属性	数据类型	必填	说明
rowNum	number	是	表格行数(最大为20)
columnNum	number	是	表格列数(最大为20)
option	JSON	否	option.title 为表格标题

返回值

Promise<Word.Table>

示例

// 在当前选区位置插入表格
async function example1() {
  const table = await Application.ActiveDocument.Tables.add(2, 2, { title: '价格表' });
}

// 在指定区域插入表格
async function example2() {
  const bm = await Application.ActiveDocument.Bookmarks.item('bm1');
  const range = await bm.range;
  const table = await range.Tables.add(2, 2, { title: '价格表' });
}

item

根据参数获取表格对象。

语法

Tables.item(key)

参数

属性	数据类型	必填	说明
key	string|number	是	表格标题/序号（序号从1开始）

返回值

Promise<Word.Table>

示例

async function example() {
  const table = await Application.ActiveDocument.Tables.item(1);
}