跳到主要内容

AddDefName

向当前工作表添加新名称。

语法

expression.AddDefName(sName, sRef, isHidden);

expression - 表示 ApiWorksheet 类的变量。

参数

名称必需/可选数据类型默认值描述
sName必需string范围名称。
sRef必需string必须包含工作表名称,后跟 ! 符号和单元格区域。示例:"Sheet1!$A$1:$B$2"。
isHidden必需boolean定义范围名称是否隐藏。

返回值

boolean

示例

在电子表格中为单元格范围分配自定义名称。

// How do I label a group of cells so I can refer to them by name in a spreadsheet?

// Give a range a memorable label instead of using raw cell addresses.

let worksheet = Api.GetActiveSheet();
worksheet.GetRange("A1").SetValue("1");
worksheet.GetRange("B1").SetValue("2");
worksheet.AddDefName("numbers", "Sheet1!$A$1:$B$1");
worksheet.GetRange("A3").SetValue("We defined a name 'numbers' for a range of cells A1:B1.");