Names.Add 方法 (Excel)

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

语法

表达式添加 (NameRefersToVisibleMacroTypeShortcutKeyCategoryNameLocalRefersToLocalCategoryLocalRefersToR1C1RefersToR1C1Local)

表达 一个代表 Names 对象的变量。

参数

名称 必需/可选 数据类型 说明
Name 可选 Variant 指定要在未指定 NameLocal 参数时用作名称的英文文本。 名称不能包括空格,并且不能设置为单元格引用的格式。
RefersTo 可选 Variant 如果未指定 RefersToLocalRefersToR1C1 和 RefersToR1C1Local 参数,则使用 A1 样式表示法描述名称所引用的名称。

注意:如果引用不存在,则 不返回任何 内容。
Visible 可选 Variant True 指定将名称定义为可见。 False 指定将名称定义为隐藏。 已隐藏的名称不会在“定义名称”“粘贴名称”“转到”对话框中显示。 默认值为 True
MacroType 可选 Variant 由以下值之一确定的宏类型:
  • 1 - 用户定义函数(Function 过程)

  • 2 - 宏(Sub 过程)

  • 3 或省略 - 无 (名称不引用用户定义的函数或宏)

ShortcutKey 可选 Variant 指定宏的快捷键。 必须是单个字母,例如“z”或“Z”。 仅适用于命令宏。
类别 可选 Variant 如果 MacroType 参数等于 1 或 2,则此参数为宏或函数的分类。 该分类在“函数向导”中使用。 可以用数字(从 1 开始)或名称(以英文指定)引用现有的分类。 如果指定的类别不存在,Excel 将创建新类别。
NameLocal 可选 Variant 如果未指定 Name 参数,则指定要用作名称的本地化文本。 名称不能包括空格,并且不能设置为单元格引用的格式。
RefersToLocal 可选 Variant 如果未指定 RefersToRefersToR1C1RefersToR1C1Local 参数,则说明名称引用的内容(使用 A1 格式表示法以本地化的文本表示)。
CategoryLocal 可选 Variant 如果未指定 Category 参数,则指定标识自定义函数分类的本地化的文本。
RefersToR1C1 可选 Variant 如果未指定 RefersToRefersToLocalRefersToR1C1Local 参数,则说明名称引用的内容(使用 R1C1 格式表示法以英文表示)。
RefersToR1C1Local 可选 Variant 如果未指定 RefersToRefersToLocalRefersToR1C1 参数,则说明名称引用的内容(使用 R1C1 格式表示法以本地化的文本表示)。

返回值

一个 Name 对象,表示新名称。

示例

此示例为活动工作簿中 Sheet1 上的区域 A1:D3 定义一个新名称。

注意

如果工作表 Sheet1 不存在,则返回 Nothing

Sub MakeRange() 
 
    ActiveWorkbook.Names.Add _ 
        Name:="tempRange", _ 
        RefersTo:="=Sheet1!$A$1:$D$3" 
 
End Sub

支持和反馈

有关于 Office VBA 或本文档的疑问或反馈? 请参阅 Office VBA 支持和反馈,获取有关如何接收支持和提供反馈的指南。