金山文档开放平台主题
表格列
Columns
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
获取表格列
语法
表达式.ActiveDocument.Tables.Item(Index).Columns
表达式：文档类型应用对象
示例
//@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 columns = tableOne.Columns
}
Count
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
获取表格总列数
语法
表达式.ActiveDocument.Tables.Item(Index).Columns.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 columns = await tableOne.Columns
// 获取表格总列数
const count = await columns.Count
console.log(count)
}
Add()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
插入表格列
语法
表达式.ActiveDocument.Tables.Item(Index).Columns.Add({ BeforeColumn })
表达式：文档类型应用对象
参数
| 属性 | 数据类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
BeforeColumn | Number | 是 | 代表将会直接显示在新列右侧的 Column 对象 |
示例
//@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 columns = await tableOne.Columns
// 插入列
await columns.Add(1)
}
Item()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
获取表格第 Index 列。返回集合中的单个 Column 对象
语法
表达式.ActiveDocument.Tables.Item(Index).Columns.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 columns = await tableOne.Columns
// 获取表格第 1 列
const columnOne = await columns.Item(1)
}
Item().Cells
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
表格中的单元格。返回一个 Cells 集合，该集合代表列、行、选定内容或区域中的表格单元格。此为只读属性
语法
表达式.ActiveDocument.Tables.Item(Index).Columns.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 columns = await tableOne.Columns
// 获取表格第 1 列
const columnOne = await columns.Item(1)
// 获取第 1 列的 Cells 对象
const cells = columnOne.Cells
}
Item().Delete()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
删除表格列
语法
表达式.ActiveDocument.Tables.Item(Index).Columns.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 columns = await tableOne.Columns
// 获取表格第 1 列
const columnOne = await columns.Item(1)
// 删除第 1 列
columnOne.Delete()
}
Item().SetWidth()
JSSDK: v1.1.10+、WebOffice v1.67.1+ 支持
仅支持 PC 端
设置表格列的宽度
语法
表达式.ActiveDocument.Tables.Item(Index).Columns.Item(Index).SetWidth({ ColumnWidth, RulerStyle })
表达式：文档类型应用对象
参数
| 属性 | 数据类型 | 默认值 | 必填 | 说明 |
|---|---|---|---|---|
ColumnWidth | Number | 是 | 指定列的宽度，以磅为单位 | |
RulerStyle | Enum | 否 | 控制 Word（文字）调整单元格宽度的方式，可参照 Enum.WdRulerStyle |
示例
//@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 columns = await tableOne.Columns
// 获取表格第 1 列
const columnOne = await columns.Item(1)
// 调整第 1 列宽度
columnOne.SetWidth(50)
}