表格行(Rows)

表示表格的行

属性列表

属性	说明
Count	获取表格总行数

方法列表

方法	说明
Add()	插入表格行
Item()	获取第 Index 行。返回集合中的单个 Row 对象
Item(Index).Range	表格行的范围。返回一个 Range 对象，该对象代表指定表格行中包含的文档部分
Item(Index).Cells	表格中的单元格。返回一个 Cells 集合，该集合代表列、行、选定内容或区域中的表格单元格。此为只读属性
Item(Index).Delete()	删除表格行
Item(Index).SetHeight()	设置表格行的宽度

Count

仅支持 PC 端

获取表格总行数

语法

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

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

示例

//@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)

  // 获取表格所有行
  const rows = await tableOne.Rows

  // 获取表格总行数
  const count = await rows.Count
  console.log(count)
}

Add()

仅支持 PC 端

插入表格行

语法

表达式.ActiveDocument.Tables.Item(Index).Rows.Add(BeforeRow)

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

参数

属性	数据类型	默认值	必填	说明
BeforeRow	Number		是	代表将会直接显示在新行下方的 Rows 对象

示例

//@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)

  // 获取表格所有行
  const rows = await tableOne.Rows

  // 插入行
  await rows.Add(1)
}

Item()

仅支持 PC 端

获取第 Index 行。返回集合中的单个 Row 对象

语法

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

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

参数

属性	数据类型	默认值	必填	说明
Index	Number		是	第 Index 行

示例

//@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)

  // 获取表格所有行
  const rows = await tableOne.Rows

  // 获取表格第 1 行
  const rowOne = await rows.Item(1)
}

Item(Index).Range

仅支持 PC 端

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

语法

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

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

示例

//@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)

  // 获取表格所有行
  const rows = await tableOne.Rows

  // 获取表格第 1 行
  const rowOne = await rows.Item(1)

  // 获取第 1 行的 Range 对象
  const range = rowOne.Range
}

Item(Index).Cells

仅支持 PC 端

表格中的单元格。返回一个 Cells 集合，该集合代表列、行、选定内容或区域中的表格单元格。此为只读属性

语法

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

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

示例

//@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)

  // 获取表格所有行
  const rows = await tableOne.Rows

  // 获取表格第 1 行
  const rowOne = await rows.Item(1)

  // 获取第 1 行的 Cells 对象
  const cells = rowOne.Cells
}

Item(Index).Delete()

仅支持 PC 端

删除表格行

语法

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

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

示例

//@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)

  // 获取表格所有行
  const rows = await tableOne.Rows

  // 获取表格第 1 行
  const rowOne = await rows.Item(1)

  // 删除第 1 行
  rowOne.Delete()
}

Item(Index).SetHeight()

仅支持 PC 端

设置表格行的宽度

语法

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

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

参数

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

示例

//@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)

  // 获取表格所有行
  const rows = await tableOne.Rows

  // 获取表格第 1 行
  const rowOne = await rows.Item(1)

  // 调整第 1 行高度
  rowOne.SetHeight(50)
}