Names

Names

返回一个Name对象的集合

属性

count

返回集合中名称的数量

语法

Names.count

Names: 名称集合对象

返回值

Promise<number>

示例

async function example() {
  // 活动工作簿
  const activeWorkbook = await Application.ActiveWorkbook;
  // 工作簿名称的集合
  const names = await activeWorkbook.Names;
  // 查看名称的数量
  const count = await names.count;
  console.log(count);
}

方法

add

新建名称

语法

Names.add(Name, RefersTo)

Names: 名称集合对象

参数

属性	数据类型	必填	说明
Name	string	是	定义的名称
RefersTo	string	是	名称的引用区间

返回值

Promise<Name>

示例

async function example() {
  // 活动工作簿
  const activeWorkbook = await Application.ActiveWorkbook;
  // 工作簿名称的集合
  const names = await activeWorkbook.Names;
  // 新增一个名称
  await names.add("名称1", "=Sheet1!$A$1:$B$4");
}

item

返回单个名称对象

语法

Names.item(index)

参数

属性	数据类型	必填	说明
index	number(string)	是	名称的索引值或者名称的name

返回值

Promise<Name>

示例

async function example() {
  // 活动工作簿
  const activeWorkbook = await Application.ActiveWorkbook;
  // 工作簿名称的集合
  const names = await activeWorkbook.Names;
  // 单个名称对象
  const name1 = await names.item(1);
  const name2 = await names.item('名称1');
}