Lire en anglais

Partager via


Names.Add, méthode (Excel)

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.

Notes

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.