Skip to content

Add (方法)

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

参数

属性数据类型必填说明
Nameany可选如果未指定 NameLocal 参数,则指定要用作名称的英文文本。名称不能包括空格,并且不能设置为单元格引用的格式。
RefersToany可选如果未指定 RefersToLocal、RefersToR1C1 和 RefersToR1C1Local 参数,则说明名称引用的内容(使用 A1 格式表示法以英文表示)。 注释 如果引用不存在,则返回 null。
Visibleany可选True 指定将名称定义为可见。False 指定将名称定义为隐藏。已隐藏的名称不会在“定义名称”、“粘贴名称”或“转到”对话框中显示。默认值为 True。
MacroTypeany可选由以下值之一确定的宏类型: 1 - 用户定义函数(Function 过程) 2 - 宏(Sub 过程) 3 或省略 - 无(该名称不引用用户定义函数或宏)
ShortcutKeyany可选指定宏的快捷键。必须是单个字母,例如“z”或“Z”。仅适用于命令宏。
Categoryany可选如果 MacroType 参数等于 1 或 2,则此参数为宏或函数的分类。该分类在“函数向导”中使用。可以用数字(从 1 开始)或名称(以英文指定)引用现有的分类。如果指定的分类不存在,ET 将创建新分类。
NameLocalany可选如果未指定 Name 参数,则指定要用作名称的本地化的文本。名称不能包括空格,并且不能设置为单元格引用的格式。
RefersToLocalany可选如果未指定 RefersTo、RefersToR1C1 和 RefersToR1C1Local 参数,则说明名称引用的内容(使用 A1 格式表示法以本地化的文本表示)。
CategoryLocalany可选如果未指定 Category 参数,则指定标识自定义函数分类的本地化的文本。
RefersToR1C1any可选如果未指定 RefersTo、RefersToLocal 和 RefersToR1C1Local 参数,则说明名称引用的内容(使用 R1C1 格式表示法以英文表示)。
RefersToR1C1Localany可选如果未指定 RefersTo、RefersToLocal 和 RefersToR1C1 参数,则说明名称引用的内容(使用 R1C1 格式表示法以本地化的文本表示)。

示例

javascript
/*此示例为活动工作簿中 Sheet1 上的区域 A1:D3 定义一个新名称,如果工作表 Sheet1 不存在,则返回 null。*/
function test() {
    Application.ActiveWorkbook.Names.Add("tempRange", "=Sheet1!$A$1:$D$3")
}
javascript
/*此示例在单元格C1中定义一个新名称并隐藏。*/
function test() {
    Application.Names.Add("test3", "=Sheet1!$C$1", false)
}