Прочитать на английском

Поделиться через


Метод Names.Add (Excel)

Определяет новое имя для диапазона ячеек.

Синтаксис

expression. Add (Name, RefersTo, Visible, MacroType, ShortcutKey, Category, NameLocal, RefersToLocal, CategoryLocal, RefersToR1C1, RefersToR1C1Local)

Выражение Переменная, представляющая объект Names .

Параметры

Имя Обязательный или необязательный Тип данных Описание
Name Необязательно заполнять. Variant Указывает текст на английском языке, который будет использоваться в качестве имени, если параметр NameLocal не указан. Имена не могут содержать пробелы и не могут быть отформатированы в виде ссылок на ячейки.
RefersTo Необязательный Variant Описывает, на что ссылается имя на английском языке с помощью нотации в стиле A1, если параметры RefersToLocal, RefersToR1C1 и RefersToR1C1Local не указаны.

ПРИМЕЧАНИЕ. Если ссылка не существует, ничего не возвращается.
Visible Необязательный Variant Значение True указывает, что имя определяется как видимое. Значение False указывает, что имя определено как скрытое. Скрытое имя не отображается в диалоговом окне Определение имени, Имя вставки или Goto . Значение по умолчанию — True.
MacroType Необязательный Variant Тип макроса, определяемый одним из следующих значений:
  • 1 — определяемая пользователем функция (процедура функции )

  • 2 . Макрос (вложенная процедура)

  • 3 или опущено — нет (имя не ссылается на определяемую пользователем функцию или макрос)

ShortcutKey Необязательный Variant Указывает сочетание клавиш макросов. Должна быть одна буква, например "z" или "Z". Применяется только для макросов команд.
Категория Необязательный Variant Категория макроса или функции, если аргумент MacroType равен 1 или 2. Категория используется в мастере функций. На существующие категории можно ссылаться либо по номеру, начиная с 1, либо по имени на английском языке. Excel создает новую категорию, если указанная категория не существует.
NameLocal Необязательный Variant Указывает локализованный текст, который будет использоваться в качестве имени, если параметр Name не указан. Имена не могут содержать пробелы и не могут быть отформатированы в виде ссылок на ячейки.
RefersToLocal Необязательный Variant Описывает, на что ссылается имя, в локализованном тексте с использованием нотации в стиле A1, если параметры RefersTo, RefersToR1C1 и RefersToR1C1Local не указаны.
CategoryLocal Необязательный Variant Указывает локализованный текст, определяющий категорию пользовательской функции, если параметр Category не указан.
RefersToR1C1 Необязательный Variant Описывает, на что ссылается имя, на английском языке с использованием нотации в стиле R1C1, если не указаны параметры RefersTo, RefersToLocal и RefersToR1C1Local .
RefersToR1C1Local Необязательный Variant Описывает, на что ссылается имя, в локализованном тексте с использованием нотации в стиле R1C1, если параметры RefersTo, RefersToLocal и RefersToR1C1 не указаны.

Возвращаемое значение

Объект Name , представляющий новое имя.

Пример

В этом примере определяется новое имя диапазона A1:D3 на Листе1 в активной книге.

Примечание

Если Sheet1 не существует, ничего не возвращается.

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

Поддержка и обратная связь

Есть вопросы или отзывы, касающиеся Office VBA или этой статьи? Руководство по другим способам получения поддержки и отправки отзывов см. в статье Поддержка Office VBA и обратная связь.