Aller au contenu principal
Version: 20 R6 BETA

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

The VP ADD RANGE NAME command creates or modifies a named range in the open document.

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

In rangeObj, pass the range that you want to name and in name, pass the new name for the range. 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).

You can pass an object with additional properties for the named range in options. Les propriétés suivantes sont prises en charge :

PropriétéTypeDescription
scopeNumberScope de la plage. You can pass the sheet index (counting begins at 0) or use the following constants:
  • vk current sheet
  • vk workbook
  • The scope determines whether a range name is local to a given worksheet (scope=sheet index or vk current sheet), or global across the entire workbook (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. VP ADD RANGE NAME facilitates the creation of named ranges, but you can also use the VP ADD FORMULA NAME method to create named ranges.
    • Formulas defining named ranges can be retrieved with the VP Get formula by name method.

    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