Border

本文介绍与表格文档Border相关的API。

Border

Range.Borders.Item()

获取单个边框对象。

  • 语法

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

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

  • 参数

    属性

    数据类型

    是否必填

    描述

    Index

    Enum

    指定要检索的边框。更多信息,请参见XlBordersIndex

  • 示例

    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);
    }

属性

Range.Borders.Item(Index).Color

通过Color属性,您可以获取指定边框的颜色。

重要

获取边框颜色时,需要指定具体的边框,即枚举值Enum.XlBordersIndex不能是xlOutsidexlInside。

  • 语法

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

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

  • 示例

    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);
    }
    

Range.Borders.Item(Index).LineStyle

通过LineStyle属性,您可以设置指定边框的线条样式。更多信息,请参见XlLineStyle

  • 语法

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

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

  • 示例

    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);
    
      //设置边框的线条样式
      border.LineStyle = app.Enum.XlLineStyle.xlDash;
    }
    

Range.Borders.Item(Index).Weight

通过Weight属性,您可以设置指定边框的粗细。更多信息,请参见XlBorderWeight

  • 语法

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

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

  • 示例

    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);
    
      //设置边框的粗细
      border.Weight = app.Enum.XlBorderWeight.xlThick;
    }
    

Borders

Range.Borders

获取指定区域中的所有边框。

  • 语法

    表达式.Range.Borders

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //获取区域对象
      const range = await app.Range('A1');
    
      //获取所有边框
      const borders = await range.Borders;
    }