VP ADD RANGE NAME

4D v19

VP ADD RANGE NAME


VP ADD RANGE NAME ( objPlage ; nom {; options} )

Paramètre	Type	Description
objPlage	Objet	Objet plage
nom	Texte	Nom de la plage
options	Objet	Options de la plage nommée

Description

La commande VP ADD RANGE NAME permet de créer ou de modifier une plage nommée dans le document courant.

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

Dans objPlage, passez la plage que vous souhaitez nommer, et passez le nouveau nom de la plage dans nom. Si le nom est déjà utilisé dans le même scope, la nouvelle plage nommée remplace la plage existante. Notez que vous pouvez utiliser le même nom pour des scopes différents (voir ci-dessous).

Note : Le scope est l'espace de la zone dans lequel la plage est créée.

Dans options, vous pouvez passer un objet afin de définir des propriétés supplémentaires pour la plage nommée. Les propriétés suivantes sont prises en charge :

Propriété

Type

Description

scope

Numérique

Scope de la plage. Vous pouvez passer l'indice de la feuille (la numérotation commence à zéro) ou utiliser les constantes suivantes :

Constante	Valeur	Comment
vk current sheet	-1	Désigne la feuille courante de la zone 4D View Pro (par défaut)
vk workbook	-2	Désigne l'intégralité du classeur (workbook) de la zone 4D View Pro.

Note : Le scope détermine si un nom de plage est propre à une feuille donnée (scope= indice de la feuille ou vk current sheet), ou s'il s'applique à l'ensemble du classeur (scope=vk workbook).

comment

Texte

Commentaire associé à la plage nommée

Notes :

Une plage nommée est en réalité une formule nommée contenant des coordonnées. VP ADD RANGE NAME facilite la création de plages nommées, mais la commande VP ADD FORMULA NAME permet également d'en créer.
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 aussi

VP Get names
VP Name