金山文档开放平台

主题

回到顶部
本页内容

边框

Borders

边框对象集合

语法

表达式.Range.Borders

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

示例 

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

  const app = instance.Application

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

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

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(1)
}

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
}