WebOffice 开放平台

主题

回到顶部
本页内容

表格列(Columns)

表格列对象的集合

属性列表

属性说明
Count
获取表格总列数

方法列表

方法说明
Add()
插入表格列
Item()
获取表格第 Index 列。返回集合中的单个 Column 对象
Item().Cells
表格中的单元格。返回一个 Cells 集合，该集合代表列、行、选定内容或区域中的表格单元格。此为只读属性
Item().Delete()
删除表格列
Item().SetWidth()
设置表格列的宽度

Count

仅支持 PC 端

获取表格总列数

语法

表达式.ActiveDocument.Tables.Item(Index).Columns.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 columns = await tableOne.Columns

  // 获取表格总列数
  const count = await columns.Count
  console.log(count)
}

Add()

仅支持 PC 端

插入表格列

语法

表达式.ActiveDocument.Tables.Item(Index).Columns.Add(BeforeColumn)

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

参数

属性数据类型默认值必填说明
BeforeColumn
Number
是
代表将会直接显示在新列右侧的 Column 对象

示例

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 columns = await tableOne.Columns

  // 插入列
  await columns.Add(1)
}

Item()

仅支持 PC 端

获取表格第 Index 列。返回集合中的单个 Column 对象

语法

表达式.ActiveDocument.Tables.Item(Index).Columns.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 columns = await tableOne.Columns

  // 获取表格第 1 列
  const columnOne = await columns.Item(1)
}

Item().Cells

仅支持 PC 端

表格中的单元格。返回一个 Cells 集合，该集合代表列、行、选定内容或区域中的表格单元格。此为只读属性

语法

表达式.ActiveDocument.Tables.Item(Index).Columns.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 columns = await tableOne.Columns

  // 获取表格第 1 列
  const columnOne = await columns.Item(1)

  // 获取第 1 列的 Cells 对象
  const cells = await columnOne.Cells
}

Item().Delete()

仅支持 PC 端

删除表格列

语法

表达式.ActiveDocument.Tables.Item(Index).Columns.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 columns = await tableOne.Columns

  // 获取表格第 1 列
  const columnOne = await columns.Item(1)

  // 删除第 1 列
  columnOne.Delete()
}

Item().SetWidth()

仅支持 PC 端

设置表格列的宽度

语法

表达式.ActiveDocument.Tables.Item(Index).Columns.Item(Index).SetWidth(ColumnWidth, RulerStyle)

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

参数

属性数据类型默认值必填说明
ColumnWidth
Number
是
指定列的宽度，以像素为单位
RulerStyle
Enum
否
控制 Word（文字）调整单元格宽度的方式，可参照 Enum.WdRulerStyle

示例

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 columns = await tableOne.Columns

  // 获取表格第 1 列
  const columnOne = await columns.Item(1)

  // 调整第 1 列宽度
  columnOne.SetWidth(50)
}