名称管理器

获取名称对象

获取名称对象，返回一个Name集合，该集合代表所有工作表特定的名称。

• 语法

  表达式.ActiveWorkbook.ActiveSheet.Names

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

• 示例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    //获取活动工作簿中的活动工作表
    const activeSheet = await app.ActiveWorkbook.ActiveSheet;
  
    //获取名称对象，返回一个Name集合，该集合代表所有工作表特定的名称
    const names = await activeSheet.Names;
  }

新建名称

为单元格区域定义新名称。

• 语法

  表达式.ActiveWorkbook.ActiveSheet.Names.Add({ Name, RefersTo })

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

• 参数

  属性	数据类型	是否必填	描述
  Name	String	是	名称。
  RefersTo	Number	否	名称引用的内容。

• 示例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    //获取活动工作簿中的活动工作表
    const activeSheet = await app.ActiveWorkbook.ActiveSheet;
  
    //获取工作表名称的集合
    const names = await activeSheet.Names;
  
    //新增一个名称
    names.Add('新表', 'A1');
  }

查看名称数量

查看工作表名称数量。

• 语法

  表达式.ActiveWorkbook.ActiveSheet.Names.Count

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

• 示例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    //获取活动工作簿中的活动工作表
    const activeSheet = await app.ActiveWorkbook.ActiveSheet;
  
    //获取工作表名称的集合
    const names = await activeSheet.Names;
  
    //查看名称数量
    const count = await names.Count;
    console.log(count);
  }

单个名称

获取单个名称对象

获取第Index个名称。

• 语法

  表达式.ActiveWorkbook.ActiveSheet.Names.Item(Index)

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

• 示例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    //获取活动工作簿中的活动工作表
    const activeSheet = await app.ActiveWorkbook.ActiveSheet;
  
    //获取名称对象
    const names = await activeSheet.Names;
  
    //获取单个名称对象
    const name = await names.Item(1);
  }

查看具体名称

• 语法

  表达式.ActiveWorkbook.ActiveSheet.Names.Item(Index).Name

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

• 示例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    //获取活动工作簿中的活动工作表
    const activeSheet = await app.ActiveWorkbook.ActiveSheet;
  
    //获取名称对象
    const names = await activeSheet.Names;
  
    //获取单个名称对象
    const name = await names.Item(1);
  
    //查看具体名称
    const nameName = await name.Name;
    console.log(nameName);
  }

获取名称的值

• 语法

  表达式.ActiveWorkbook.ActiveSheet.Names.Item(Index).Value

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

• 示例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    //获取活动工作簿中的活动工作表
    const activeSheet = await app.ActiveWorkbook.ActiveSheet;
  
    //获取名称对象
    const names = await activeSheet.Names;
  
    //获取单个名称对象
    const name = await names.Item(1);
  
    //获取名称的值
    const value = await name.Value;
    console.log(value);
  }

删除名称

• 语法

  表达式.ActiveWorkbook.ActiveSheet.Names.Item(Index).Delete()

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

• 示例

  async function example() {
    await instance.ready();
  
    const app = instance.Application;
    
    //获取活动工作簿中的活动工作表
    const activeSheet = await app.ActiveWorkbook.ActiveSheet;
  
    //获取名称对象
    const names = await activeSheet.Names;
  
    //获取单个名称对象
    const name = await names.Item(1);
  
    //删除名称
    await name.Delete();
  }