Aller au contenu principal
Version: Next

VP Get formula by name

VP Get formula by name ( vpAreaName : Text ; name : Text { ; scope : Number } ) : Object

ParamètresTypeDescription
vpAreaNameText->Nom d'objet formulaire zone 4D View Pro
nameText->Nom de la plage nommée
scopeNumber->"Scope" cible (par défaut=feuille courante)
RésultatObject<-Définition de la formule nommée ou de la plage nommée

Description

The VP Get formula by name command returns the formula and comment corresponding to the named range or named formula passed in the name parameter, or null if it does not exist in the defined scope.

In vpAreaName, pass the name of the 4D View Pro area. Si vous passez un nom inexistant, une erreur est retournée.

Pass the named range or named formula that you want to get in name. A noter que les plages nommées sont retournées sous forme de formules contenant des références absolues de cellules.

You can define where to get the formula in scope using either the sheet index (counting begins at 0) or the following constants:

  • vk current sheet
  • vk workbook
Objet retourné

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

PropriétéTypeDescription
formulaTextTexte 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.
commentTextCommentaire 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 (if not existing)

Voir également

VP ADD FORMULA NAME
VP Get names