金山文档开放平台主题
表格行
Rows
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
获取表格行
语法
表达式.ActiveDocument.Tables.Item(Index).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)
// 获取第 1 个表格的所有行
const rows = tableOne.Rows
}
Count
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 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()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 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()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 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).Cells
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 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).Range
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 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).Delete()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 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()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 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)
}