WebOffice 开放平台主题
单元格(Cells)
表格列、表格行、选定内容或区域中的 Cell 对象的集合。
方法列表
| 方法 | 说明 | 支持度 |
|---|---|---|
第 Index 个单元格。返回集合中的单个 Cell 对象 | JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持 | |
单元格行的范围。返回一个 Range 对象，该对象代表指定单元格行中包含的文档部分 | JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持 | |
删除单元格 | JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持 | |
设置表格列的高度 | JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持 | |
设置表格行的宽度 | JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持 |
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 个单元格 |
示例
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
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 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()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 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()
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 |
示例
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()
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 |
示例
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)
}