Aller au contenu principal
Version: Next

VP ADD RANGE NAME

VP ADD RANGE NAME ( rangeObj : Object ; name : Text { ; options : Object } )

ParamètresTypeDescription
rangeObjObject->Objet plage
nameText->Nom de la formule
optionsObject->Options de la formule nommée

Description

La commande VP ADD RANGE NAME crée ou modifie une plage nommée dans le document courant.

Les plages nommées créées par cette commande sont stockées dans le document.

Dans rangeObj, passez la plage que vous souhaitez nommer et dans name, passez le nouveau nom pour la plage. Si le nom est déjà utilisé dans le même scope, la nouvelle plage nommée remplace la plage existante. A noter que vous pouvez utiliser le même nom pour plusieurs scopes (ci-dessous).

Vous pouvez passer un objet avec des propriétés supplémentaires pour la plage nommée dans options. Les propriétés suivantes sont prises en charge :

PropriétéTypeDescription
scopeNumberScope de la plage. Vous pouvez passer l'index de la feuille (la numérotation commence à zéro) ou utiliser les constantes suivantes:
  • vk current sheet
  • vk workbook
  • Le scope détermine si le nom d'une plage est propre à une feuille (scope=sheet index ou vk current sheet), ou s'il s'applique à l'ensemble du classeur (scope=vk workbook).
    commentTextCommentaire associé à une plage nommée
    • Une plage nommée est en réalité une formule nommée contenant des coordonnées. La commande VP ADD RANGE NAME facilite la création de plages nommées, mais vous pouvez également utiliser la méthode VP ADD FORMULA NAME pour créer des plages nommées.
    • Les formules définissant des plages nommées peuvent être récupérées à l'aide de la commande VP Get formula by name.

    Exemple

    Vous souhaitez créer une plage nommée à partir d'une plage contenant une cellule :

    $range:=VP Cell("ViewProArea";2;10)
    VP ADD RANGE NAME($range;"Total1")

    Voir également

    VP Get names
    VP Name