Names.Add-Methode (Excel)

  • Artikel

Legt einen neuen Namen für einen Zellbereich fest.

Syntax

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

Ausdruck Eine Variable, die ein Names-Objekt darstellt.

Parameter

Name Erforderlich/Optional Datentyp Beschreibung
Name Optional Variant Gibt den Text in englischer Sprache an, der als Name verwendet werden soll, wenn der NameLocal-Parameter nicht angegeben ist. Namen dürfen keine Leerzeichen enthalten und nicht als Zellbezüge formatiert werden.
RefersTo Optional Variant Beschreibt, worauf sich der Name in englischer Sprache mit A1-Schreibweise bezieht, wenn die Parameter RefersToLocal, RefersToR1C1 und RefersToR1C1Local nicht angegeben sind.

HINWEIS: Wenn der Verweis nicht vorhanden ist, wird nichts zurückgegeben.
Visible Optional Variant Mit True wird der Name als sichtbar definiert. Mit False wird er als ausgeblendet definiert. Ein ausgeblendeter Name wird in den Dialogfeldern Namen definieren, Namen einfügen oder Gehe zu nicht angezeigt. Der Standardwert ist True.
MacroType Optional Variant Der Makrotyp, der von einem der folgenden Werte bestimmt wird:

  • 1 - benutzerdefinierte Funktion (Function-Prozedur)

  • 2 - Makro (Unterprozedur)

  • 3 oder nicht angegeben - None (der Name bezieht sich nicht auf eine benutzerdefinierte Funktion oder ein Makro)
ShortcutKey Optional Variant Gibt die Tastenkombination des Makros an. Muss ein einzelner Buchstabe sein, z. B. "z" oder "Z". Gilt nur für Befehlsmakros.
Category Optional Variant Die Kategorie des Makros oder der Funktion, wenn das MacroType-Argument gleich 1 oder 2 ist. Die Kategorie wird im Funktions-Assistenten verwendet. Der Bezug auf bestehende Kategorien kann in Form einer Zahl (beginnend mit 1) oder eines Namens (in Englisch) hergestellt werden. Excel erstellt eine neue Kategorie, wenn die angegebene Kategorie nicht vorhanden ist.
NameLocal Optional Variant Gibt den lokalisierten Text an, der als Name verwendet werden soll, wenn der Name-Parameter nicht angegeben ist. Namen dürfen keine Leerzeichen enthalten und nicht als Zellbezüge formatiert werden.
RefersToLocal Optional Variant Beschreibt, worauf sich der Name in lokalisiertem Text mit A1-Schreibweise bezieht, wenn die Parameter RefersTo, RefersToR1C1 und RefersToR1C1Local nicht angegeben sind.
CategoryLocal Optional Variant Gibt den lokalisierten Text an, der die Kategorie einer benutzerdefinierten Funktion identifiziert, wenn der Category-Parameter nicht angegeben ist.
RefersToR1C1 Optional Variant Beschreibt, worauf sich der Name in englischer Sprache mit R1C1-Notation bezieht, wenn die Parameter RefersTo, RefersToLocal und RefersToR1C1Local nicht angegeben sind.
RefersToR1C1Local Optional Variant Beschreibt, worauf sich der Name in lokalisiertem Text mit R1C1-Notation bezieht, wenn die Parameter RefersTo, RefersToLocal und RefersToR1C1 nicht angegeben sind.

Rückgabewert

Ein Name-Objekt , das den neuen Namen darstellt.

Beispiel

In diesem Beispiel wird ein neuer Name für den Bereich A1:D3 auf Sheet1 in der aktiven Arbeitsmappe definiert.

Hinweis

Nothing wird zurückgegeben, wenn "Blatt1" nicht vorhanden ist.

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

Support und Feedback

Haben Sie Fragen oder Feedback zu Office VBA oder zu dieser Dokumentation? Unter Office VBA-Support und Feedback finden Sie Hilfestellung zu den Möglichkeiten, wie Sie Support erhalten und Feedback abgeben können.