WebOffice 开放平台

主题

回到顶部
本页内容

表格行(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

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

示例

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)

  // 获取表格所有行
  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 对象

示例

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)

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

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

Item()

仅支持 PC 端

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

语法

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

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

参数

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

示例

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)

  // 获取表格所有行
  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

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

示例

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)

  // 获取表格所有行
  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

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

示例

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)

  // 获取表格所有行
  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()

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

示例

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)

  // 获取表格所有行
  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

示例

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)

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

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

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