名称(Names)

给特定的区域、内容或者公式定义一个名称，方便在公式中引用（例如：=数量\*单价）。

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

属性列表

属性	说明
Count	工作表名称数量

方法列表

方法	说明
Add()	为单元格区域定义新名称
ValidNewName()	检查名称是否合法
Item()	单个名称对象
Item().Name	名称的 Name
Item().Value	名称的 Value
Item().Delete()	删除名称
Item().RefersToRange	返回 Name 对象引用的 Range 对象

Count

工作表名称数量

语法

表达式.ActiveWorkbook.ActiveSheet.Names.Count

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

示例

//@file=base.xlsx
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)
}

Add()

为单元格区域定义新名称

语法

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

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

参数

属性	数据类型	默认值	必填	说明
Name	String		是	名称
RefersTo	Number		否	名称引用的内容（例如 A1）

示例

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

  const app = instance.Application

  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet

  // 工作表名称的集合
  const names = await activeSheet.Names

  // 新增一个名称
  names.Add('新表', 'A1')
}

ValidNewName()

检查名称是否合法

语法

表达式.ActiveWorkbook.ActiveSheet.Names.ValidNewName({ Name })

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

参数

属性	数据类型	默认值	必填	说明
Name	String		是	名称

示例

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

  const app = instance.Application

  // 活动工作簿中的活动工作表
  const activeSheet = await app.ActiveWorkbook.ActiveSheet

  // 工作表名称的集合
  const names = await activeSheet.Names

  // 检查名称是否合法
  names.ValidNewName('新表')
}

Item()

单个名称对象

语法

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

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

示例

//@file=base.xlsx
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)
}

Item().Name

名称的 Name

语法

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

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

示例

//@file=base.xlsx
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)
}

Item().Value

名称的 Value

语法

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

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

示例

//@file=base.xlsx
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)
}

Item().Delete()

删除名称

语法

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

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

示例

//@file=base.xlsx
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()
}

Item().RefersToRange

返回 Name 对象引用的 Range 对象

语法

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

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

示例

//@file=base.xlsx
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 range = await name.RefersToRange;
}