活动工作簿

本文介绍如何在表格文件中获取工作簿对象、工作簿名称和新增工作表等功能。

活动工作簿对象

获取一个表示活动工作簿的工作簿对象。

  • 语法

    表达式.ActiveWorkbook

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //活动工作簿
      const activeWorkbook = await app.ActiveWorkbook;
    }

名称管理器

获取工作簿名称的集合。

  • 语法

    表达式.ActiveWorkbook.Names

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //活动工作簿
      const activeWorkbook = await app.ActiveWorkbook;
    
      //工作簿名称集合
      const names = await activeWorkbook.Names;
    }

工作表

获取工作表对象

  • 语法

    表达式.ActiveWorkbook.Sheets

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //工作表对象
      const sheets = await app.ActiveWorkbook.Sheets;
    }

新增工作表

  • 语法

    表达式.ActiveWorkbook.Sheets.Add({ Before, After, Count, Type, Name })

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

  • 参数

    属性

    数据类型

    是否必填

    描述

    Before

    String/Number

    指定工作表的对象,新建的工作表将置于此工作表之前。

    After

    String/Number

    指定工作表的对象,新建的工作表将置于此工作表之后。

    Count

    Number

    要添加的工作表数。默认值为选定工作表的数量。

    Type

    Enum

    指定工作表类型。Enum.XlSheetType取值:

    • -4167或xlWorksheet:工作表。

    • -4116或xlDialogSheet:对话框工作表。

    • -4109或xlChart:图标。

    • 3或xlExcel4MacroSheet:Excel版本4宏工作表。

    • 4或xlExcel4IntlMacroSheet:Excel版本4国际宏工作表。

    Name

    Name

    指定工作表名称。

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //工作表对象
      const sheets = await app.ActiveWorkbook.Sheets;
    
      //添加工作表
      await sheets.Add(null, null, 1, app.Enum.XlSheetType.xlWorksheet, '新工作表');
    }

获取工作表数量

  • 语法

    表达式.ActiveWorkbook.Sheets.Count

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //工作表对象
      const sheets = await app.ActiveWorkbook.Sheets;
    
      //工作表数量
      const count = await sheets.Count;
      console.log(count);
    }

获取工作表类型

  • 语法

    表达式.ActiveWorkbook.Sheets.Item(Index).Type

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //工作表对象
      const sheetIndex = 2; //Sheets序号,从1开始
      const sheet = await app.ActiveWorkbook.Sheets.Item(sheetIndex)
    
      //工作表类型
      const Type = await sheet.Type;
      console.log(Type);
    }

获取单个工作表对象

获取活动工作簿中的活动工作表。

重要

目前该对象(WorkSheet)可以和活动工作表(ActiveSheet)一样使用。

  • 语法

    表达式.ActiveWorkbook.Sheets.Item(Index)

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

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //活动工作簿中的活动工作表
      const activeSheet = await app.ActiveWorkbook.Sheets.Item(1);
    }

开启或关闭多人同步筛选

  • 语法

    表达式.ActiveWorkbook.SetFilterShared({ Checked })

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

  • 参数

    属性

    数据类型

    是否必填

    描述

    Checked

    Boolean

    可开启或关闭筛选。

    • true:开启。

    • false:关闭。

  • 示例

    async function example() {
      await instance.ready();
    
      const app = instance.Application;
      
      //活动工作簿
      const activeWorkbook = await app.ActiveWorkbook;
    
      //开启多人同步筛选
      const result = await activeWorkbook.SetFilterShared(true);
    }