边框(Borders)

边框对象集合

方法列表

方法	说明
Item()	单个边框对象，代表单元格区域或样式的边框之一
Item().Color	边框颜色
Item().LineStyle	边框的线条样式
Item().Weight	边框的粗细

Item()

单个边框对象，代表单元格区域或样式的边框之一

语法

表达式.Range.Borders.Item(Index)

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

参数

属性	数据类型	默认值	必填	说明
Index	Enum		是	指定要检索的边框，参考 Enum.XlBordersIndex

示例

//@file=base.xlsx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 区域对象
  const range = await app.Range('A1')

  // 边框对象
  const borders = await range.Borders

  // 单个边框对象
  const border = await borders.Item(5)
}

Item().Color

边框颜色

语法

表达式.Range.Borders.Item(Index).Color

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

注意：获取边框颜色时，需要指定具体的边框，即枚举值 Enum.XlBordersIndex 不能是 xlAll、xlOutside、xlInside 等

示例

//@file=base.xlsx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 区域对象
  const range = await app.Range('A1')

  // 边框对象
  const borders = await range.Borders

  // 单个边框对象
  const border = await borders.Item(app.Enum.XlBordersIndex.xlEdgeLeft)

  // 获取边框颜色
  const color = await border.Color
  console.log(color)
}

Item().LineStyle

边框的线条样式

语法

表达式.Range.Borders.Item(Index).LineStyle

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

示例

//@file=base.xlsx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 区域对象
  const range = await app.Range('A3')

  // 边框对象
  const borders = await range.Borders

  // 单个边框对象
  const border = await borders.Item(app.Enum.XlBordersIndex.xlOutside)

  // 设置边框的线条样式
  border.LineStyle = app.Enum.XlLineStyle.xlDash
}

Item().Weight

边框的粗细

语法

表达式.Range.Borders.Item(Index).Weight

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

示例

//@file=base.xlsx
async function example() {
  await instance.ready()

  const app = instance.Application

  // 区域对象
  const range = await app.Range('A3')

  // 边框对象
  const borders = await range.Borders

  // 单个边框对象
  const border = await borders.Item(app.Enum.XlBordersIndex.xlOutside)

  // 设置边框的粗细
  border.Weight = app.Enum.XlBorderWeight.xlThick
}