Skip to content

名称(Names)

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

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

属性列表

属性说明
工作表名称数量

方法列表

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

Count

工作表名称数量

语法

表达式.ActiveWorkbook.ActiveSheet.Names.Count

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

示例

js
//@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)

示例

js
//@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
名称

示例

js
//@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)

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

示例

js
//@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

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

示例

js
//@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

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

示例

js
//@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()

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

示例

js
//@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

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

示例

js
//@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;
}