金山文档开放平台主题
单元格
Cells
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
表格列、表格行、选定内容或区域中的 Cell 对象的集合。
后面统一用 行（Rows）来演示对应的单元格
语法
表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells- 或者
表达式.ActiveDocument.Tables.Item(Index).Columns.Item(Index).Cells - 或者
表达式.ActiveDocument.ActiveWindow.Selection.Cells
表达式：文档类型应用对象
示例
//@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 rowText = await tableOne.Rows.Item(1).Cells.Item(1).Range.Text
console.log(rowText)
// 获取表格第 2 列的第 2 个单元格的文本
const columnText = await tableOne.Rows.Item(2).Cells.Item(2).Range.Text
console.log(columnText)
}
Item()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
第 Index 个单元格。返回集合中的单个 Cell 对象
语法
表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index)
表达式：文档类型应用对象
参数
| 属性 | 数据类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
Index | Number | 是 | 第 Index 个单元格 |
示例
//@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
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
单元格行的范围。返回一个 Range 对象，该对象代表指定单元格行中包含的文档部分
语法
表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.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)
// 获取表格第 1 行的第 1 个单元格
const cell = await tableOne.Rows.Item(1).Cells.Item(1)
// 获取该单元格的区域
const range = await cell.Range
}
Item().Delete()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
删除单元格
语法
表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).Delete()
表达式：文档类型应用对象
示例
//@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()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
设置表格列的高度
语法
表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).SetHeight({ RowHeight, HeightRule })
表达式：文档类型应用对象
参数
| 属性 | 数据类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
RowHeight | Number | 是 | 指定行的高度，以磅为单位 | |
HeightRule | Enum | 否 | 用于确定指定行的高度的规则，可参照 Enum.WdRowHeightRule |
示例
//@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()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
设置表格行的宽度
语法
表达式.ActiveDocument.Tables.Item(Index).Rows.Item(Index).Cells.Item(Index).SetWidth({ ColumnWidth, RulerStyle })
表达式：文档类型应用对象
参数
| 属性 | 数据类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
ColumnWidth | Number | 是 | 指定行的宽度，以磅为单位 | |
RulerStyle | Enum | 否 | 用于确定指定行的高度的规则，可参照 Enum.WdRowHeightRule |
示例
//@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)
}