Names.Add, méthode (Excel)

Article
04/07/2023

Cette méthode définit un nouveau nom pour une plage de cellules.

Syntaxe

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

Expression Variable qui représente un objet Names .

Parameters

Nom	Requis/Facultatif	Type de données	Description
Name	Facultatif	Variant	Spécifie le texte, en anglais, à utiliser comme nom si le paramètre NameLocal n’est pas spécifié. Les noms ne doivent pas contenir d'espaces et ne peuvent pas avoir le format des références de cellule.
RefersTo	Facultatif	Variant	Décrit ce à quoi le nom fait référence, en anglais, à l’aide de la notation de style A1, si les paramètres RefersToLocal, RefersToR1C1 et RefersToR1C1Local ne sont pas spécifiés. REMARQUE : Rien n’est retourné si la référence n’existe pas.
Visible	Facultatif	Variant	True spécifie que le nom est défini comme visible. False spécifie que le nom est défini comme masqué. Un nom masqué n’apparaît pas dans la boîte de dialogue Définir le nom, Coller le nom ou Atteindre . La valeur par défaut est True.
MacroType	Facultatif	Variante	Type de macro, déterminé par une des valeurs suivantes : 1 - Fonction définie par l'utilisateur (procédure Function) 2 - Macro (procédure Sub) 3 ou omis - Aucune (le nom ne fait référence à aucune macro ni fonction définie par l'utilisateur)
ShortcutKey	Facultatif	Variant	Indique la touche de raccourci de la macro. Il doit s'agir d'une seule lettre, telle que « z » ou « Z ». Ne s'applique qu'aux macros de commande.
Category	Facultatif	Variant	Catégorie de la macro ou de la fonction si l’argument MacroType est égal à 1 ou 2. La catégorie est utilisée dans l'Assistant Fonction. La référence à des catégories existantes s'effectue soit avec un nombre, en commençant par 1, soit avec un nom en anglais. Excel crée une catégorie si la catégorie spécifiée n’existe pas.
NameLocal	Facultatif	Variant	Spécifie le texte localisé à utiliser comme nom si le paramètre Name n’est pas spécifié. Les noms ne doivent pas contenir d'espaces et ne peuvent pas avoir le format des références de cellule.
RefersToLocal	Facultatif	Variant	Décrit à quoi le nom fait référence, dans le texte localisé à l’aide de la notation de style A1, si les paramètres RefersTo, RefersToR1C1 et RefersToR1C1Local ne sont pas spécifiés.
CategoryLocal	Facultatif	Variant	Spécifie le texte localisé qui identifie la catégorie d’une fonction personnalisée si le paramètre Category n’est pas spécifié.
RefersToR1C1	Facultatif	Variant	Décrit à quoi le nom fait référence, en anglais à l’aide de la notation de style R1C1, si les paramètres RefersTo, RefersToLocal et RefersToR1C1Local ne sont pas spécifiés.
RefersToR1C1Local	Facultatif	Variant	Décrit à quoi le nom fait référence, dans le texte localisé à l’aide de la notation de style R1C1, si les paramètres RefersTo, RefersToLocal et RefersToR1C1 ne sont pas spécifiés.

Valeur renvoyée

Objet Name qui représente le nouveau nom.

Exemple

Cet exemple montre comment définir un nouveau nom pour la plage A1:D3 située dans la feuille Sheet1 du classeur actif.

Remarque

Nothing est renvoyé si la feuille Sheet1 n’existe pas.

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

Assistance et commentaires

Avez-vous des questions ou des commentaires sur Office VBA ou sur cette documentation ? Consultez la rubrique concernant l’assistance pour Office VBA et l’envoi de commentaires afin d’obtenir des instructions pour recevoir une assistance et envoyer vos commentaires.

Partager via