Saltar al contenido principal
Versión: 20 R6

VP ADD RANGE NAME

VP ADD RANGE NAME ( rangeObj : Object ; name : Text { ; options : Object } )

ParámetrosTipoDescripción
rangeObjObject->Objeto rango
nameText->Nombre de la fórmula
optionsObject->Opciones de la fórmula temporal

Descripción

El comando VP ADD RANGE NAME crea o modifica un rango con nombre en el documento abierto.

Los rangos nombrados creados por este comando se guardan con el documento.

En rangeObj, pase el rango que quiere nombrar, y pase el nuevo nombre del rango en name. Si el nombre ya se utiliza en el mismo alcance, el nuevo rango nombrado sustituye al existente. Tenga en cuenta que puede utilizar el mismo nombre para diferentes alcances (ver más adelante).

Puede pasar un objeto con las propiedades adicionales para el rango nombrado en options. Se soportan las siguientes propiedades:

PropiedadTipoDescripción
scopeNumberAlcance del rango. Puede pasar el índice de hojas (el conteo comienza en 0) o usar las siguientes constantes:
  • vk current sheet
  • vk workbook
  • El alcance determina si un nombre de rango es local en una hoja de trabajo determinada (scope=sheet index o vk current sheet), o global en todo el libro de trabajo (scope=vk workbook).
    commentTextComentario asociado al rango nombrado
    • Un rango nombrado es en realidad una fórmula nombrada que contiene coordenadas. VP ADD RANGE NAME facilita la creación de rangos con nombre, pero también puede utilizar el método VP ADD FORMULA NAME para crear rangos temporales.
    • Las fórmulas que definen rangos con nombre pueden recuperarse con el método VP Get formula by name.

    Ejemplo

    Quiere crear un rango nombrado para un rango de celdas:

    $range:=VP Cell("ViewProArea";2;10)
    VP ADD RANGE NAME($range;"Total1")

    Ver también

    VP Get names
    VP Name