WPS WebOffice 开放平台WPS WebOffice 开放平台 | 开发文档

深色模式

单元格(Cells) ​

表格列、表格行、选定内容或区域中的 Cell 对象的集合。

方法列表 ​

方法说明
Item()
第 Index 个单元格。返回集合中的单个 Cell 对象
Item().Range
单元格行的范围。返回一个 Range 对象，该对象代表指定单元格行中包含的文档部分
Item().Delete()
删除单元格
Item().SetHeight()
设置表格列的高度
Item().SetWidth()
设置表格行的宽度
Item().Merge()
表格第Index行第Index个单元格合并另一个单元格
Item().Split()
表格第Index行第Index个单元格分割
Merge()
表格第Index行单元格集合合并
Split()
表格第Index行单元格集合分割

Item() ​

仅支持 PC 端

第 Index 个单元格。返回集合中的单个 Cell 对象

语法 ​

表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index)

表达式：文档类型应用对象

参数 ​

属性数据类型默认值必填说明
Index
Number
是
第 Index 个单元格

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 获取第 1 个表格
  const tableOne = await app.ActiveDocument.Tables.Item(1)

  // 获取表格第 1 行的第 1 个单元格
  const cell = await tableOne.Rows.Item(1).Cells.Item(1)
}

Item().Range ​

仅支持 PC 端

单元格行的范围。返回一个 Range 对象，该对象代表指定单元格行中包含的文档部分

语法 ​

表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).Range

表达式：文档类型应用对象

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 获取所有表格
  const tables = await app.ActiveDocument.Tables

  // 获取第 1 个表格
  const tableOne = await tables.Item(1)

  // 获取表格第 1 行的第 1 个单元格
  const cell = await tableOne.Rows.Item(1).Cells.Item(1)

  // 获取该单元格的区域
  const range = await cell.Range
}

Item().Delete() ​

仅支持 PC 端

删除单元格

语法 ​

表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).Delete()

表达式：文档类型应用对象

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 获取第 1 个表格
  const tableOne = await app.ActiveDocument.Tables.Item(1)

  // 获取表格第 1 行的第 1 个单元格
  const cellOne = await tableOne.Rows.Item(1).Cells.Item(1)

  // 删除该单元格所在的行
  await cellOne.Delete()
}

Item().SetHeight() ​

仅支持 PC 端

设置表格列的高度

语法 ​

表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).SetHeight(RowHeight, HeightRule)

表达式：文档类型应用对象

参数 ​

属性数据类型默认值必填说明
RowHeight
Number
是
指定行的高度，以磅为单位
HeightRule
Enum
否
用于确定指定行的高度的规则，可参照 Enum.WdRowHeightRule

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 获取第 1 个表格
  const tableOne = await app.ActiveDocument.Tables.Item(1)

  // 获取表格第 1 行的第 1 个单元格
  const cellOne = await tableOne.Rows.Item(1).Cells.Item(1)

  // 调整该单元格所在的高度
  await cellOne.SetHeight(50)
}

Item().SetWidth() ​

仅支持 PC 端

设置表格行的宽度

语法 ​

表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).SetWidth(ColumnWidth, RulerStyle)

表达式：文档类型应用对象

参数 ​

属性数据类型默认值必填说明
ColumnWidth
Number
是
指定行的宽度，以磅为单位
RulerStyle
Enum
否
用于确定指定行的高度的规则，可参照 Enum.WdRowHeightRule

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 获取第 1 个表格
  const tableOne = await app.ActiveDocument.Tables.Item(1)

  // 获取表格第 1 行的第 1 个单元格
  const cellOne = await tableOne.Rows.Item(1).Cells.Item(1)

  // 调整该单元格所在的宽度
  await cellOne.SetWidth(50)
}

Item().Merge() ​

仅支持PC端

表格第Index行第Index个单元格合并另一个单元格

语法 ​

表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).Merge(Cell)

表达式：文档类型应用对象

参数 ​

属性数据类型默认值必填说明
Cell
Cell
是
待合并的单元格

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取第 1 个表格
  const tableOne = await app.ActiveDocument.Tables.Item(1);

  // 第一行第一个单元格合并第二单元格
  await tableOne.Rows.Item(1).Cells.Item(1).Merge(tableOne.Rows.Item(1).Cells.Item(2));

  // 多个单元格合并
  // await tableOne.Rows.Item(1).Cells.Item(1).Merge(tableOne.Rows.Item(2).Cells.Item(2));
}

Item().Split() ​

仅支持PC端

表格第Index行第Index个单元格分割

语法 ​

表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).Split()

表达式：文档类型应用对象

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取第 1 个表格
  const tableOne = await app.ActiveDocument.Tables.Item(1);

  // 第一行第一个单元格合并第二单元格
  await tableOne.Rows.Item(1).Cells.Item(1).Merge(tableOne.Rows.Item(1).Cells.Item(2));
  // 分割
  await tableOne.Rows.Item(1).Cells.Item(1).Split();
}

Merge() ​

仅支持PC端

表格第Index行单元格集合合并

语法 ​

表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Merge()

表达式：文档类型应用对象

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取第 1 个表格
  const tableOne = await app.ActiveDocument.Tables.Item(1);

  // 合并
  await tableOne.Rows.Item(1).Cells.Merge();
}

Split() ​

仅支持PC端

表格第Index行单元格集合分割

语法 ​

表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Split()

表达式：文档类型应用对象

示例 ​

js
//@file=base.docx
async function example() {
  await instance.ready();

  const app = instance.Application;
  
  // 获取第 1 个表格
  const tableOne = await app.ActiveDocument.Tables.Item(1);

  // 合并
  await tableOne.Rows.Item(1).Cells.Merge();
  // 分割
  await tableOne.Rows.Item(1).Cells.Split();
}