VP Get formula by name

4D v19


VP Get formula by name ( vpAreaName ; nom {; scope} ) -> Résultat

Paramètre	Type	Description
vpAreaName	Texte	Nom de la zone 4D View Pro dans le formulaire
nom	Texte	Nom de la plage nommée
scope	Numérique	"Scope" cible (par défaut=feuille courante)
Résultat	Objet	Définition de la formule nommée ou de la plage nommée

Description

La commande VP Get formula by name retourne la formule et le commentaire correspondant à la plage nommée ou à la formule nommée qui a été passée dans le paramètre nom, ou retourne null si le nom n'existe pas dans le scope défini.

Dans vpAreaName, passez le nom de la zone 4D View Pro. Si vous passez un nom inexistant, une erreur est retournée.

Passez la plage nommée ou la formule nommée que vous souhaitez lire dans nom. Notez que les plages nommées sont retournées sous forme de formules contenant des références absolues de cellules.

Le paramètre scope vous permet de définir l'espace de la zone dans lequel lire la formule, en passant l'indice de la feuille (la numérotation débute à 0) ou l'une des 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.

L'objet retourné contient les propriétés suivantes :

Propriété	Type	Description
formula	Texte	Texte de la formule correspondant à la formule nommée ou à la plage nommée. Pour les plages nommées, la formule est une séquence de coordonnées absolues.
comment	Texte	Commentaire correspondant à la formule nommée ou à la plage nommée

Exemple

 $range:=VP Cell("ViewProArea";0;0)

 VP ADD RANGE NAME("Total1";$range)

 

 $formula:=VP Get formula by name("ViewProArea";"Total1")

  //$formula.formula=Sheet1!$A$1

 

 $formula:=VP Get formula by name("ViewProArea";"Total")

  //$formula=null (s'il n'existe pas)

Voir aussi

VP ADD FORMULA NAME
VP Get names