VP ADD FORMULA NAME

4D v19

VP ADD FORMULA NAME


VP ADD FORMULA NAME ( vpAreaName ; vpFormule ; nom {; options} )

Paramètre	Type	Description
vpAreaName	Texte	Nom de la zone 4D View Pro dans le formulaire
vpFormule	Texte	Formule 4D View Pro
nom	Texte	Nom de la formule
options	Objet	Options de la formule nommée

Description

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

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

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

Passez la formule 4D View Pro que vous souhaitez nommer dans vpFormule. Pour plus d'informations sur la syntaxe des formules, veuillez consulter la section Formules 4D View Pro.

Passez le nouveau nom de la formule dans nom. Si le nom est déjà utilisé dans le même scope, la nouvelle formule nommée remplace la formule existante. Notez que vous pouvez utiliser le même nom pour plusieurs scopes (ci-dessous).

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

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

Propriété

Type

Description

scope

Numérique

Scope de la formule. 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 le nom d'une formule est propre à une feuille (scope= indice de la feuille ou vk current sheet), ou s'il s'applique à l'ensemble du classeur (scope=vk workbook).

baseRow

Numérique

(optionnel) Point de départ personnalisé (ligne de cellule) pour les références relatives dans la formule. Si omise, les références relatives utiliseront (0;0) comme point de départ. Lorsqu'elle est utilisée, baseColumn est obligatoire.

baseColumn

Numérique

(optionnel) Point de départ personnalisé (colonne de cellule) pour les références relatives dans la formule. Si omise, les références relatives utiliseront (0;0) comme point de départ. Lorsqu'elle est utilisée, baseRow est obligatoire.

comment

Texte

Commentaire associé à une formule nommée

Exemple 1

VP ADD FORMULA NAME("ViewProArea";"SUM($A$1:$A$10)";"Total2")

Exemple 2

Vous souhaitez créer une formule nommée qui référence les deux cellules immédiatement au-dessus.

  //calculer relativement la somme de A1 à A2

  //et fonder la formule sur baseRow=2 et baseColumn=0 (A3)

 VP ADD FORMULA NAME("vpArea";"SUM(A1:A2)";"sum2Above";New object("baseRow";2;"baseColumn";0))

  //et peut ensuite être appliquée n'importe où, ici dans D5

Voir aussi

Références des cellules
VP Get formula by name
VP Get names