表格列(Columns)

表格列对象的集合

属性列表

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

方法列表

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

Count

仅支持 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()

仅支持 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()

仅支持 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

仅支持 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 = await columnOne.Cells
}

Item().Delete()

仅支持 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()

仅支持 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)
}