Skip to content
本页内容

单元格(Cells)

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

方法列表

方法说明
第 Index 个单元格。返回集合中的单个 Cell 对象
单元格行的范围。返回一个 Range 对象,该对象代表指定单元格行中包含的文档部分
删除单元格
设置表格列的高度
设置表格行的宽度

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)
}