Crea, accede y modifica rangos con nombre en una hoja de cálculo. Los rangos con nombre son rangos que tienen alias de string asociados. Se pueden ver y editar a través de la IU de Hojas de cálculo en el menú Datos > Rangos con nombre....
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
getName() | String | Obtiene el nombre de este rango con nombre. |
getRange() | Range | Obtiene el rango al que hace referencia este rango con nombre. |
remove() | void | Borra este rango con nombre. |
setName(name) | NamedRange | Establece o actualiza el nombre del rango con nombre. |
setRange(range) | NamedRange | Establece o actualiza el rango de este rango con nombre. |
Documentación detallada
getName()
Obtiene el nombre de este rango con nombre.
Devolvedor
String
: Es el nombre de este rango con nombre.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange()
Obtiene el rango al que hace referencia este rango con nombre.
Devolvedor
Range
: El rango de la hoja de cálculo asociado a este rango con nombre
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Borra este rango con nombre.
// The code below deletes all the named ranges in the spreadsheet. var namedRanges = SpreadsheetApp.getActive().getNamedRanges(); for (var i = 0; i < namedRanges.length; i++) { namedRanges[i].remove(); }
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setName(name)
Establece o actualiza el nombre del rango con nombre.
// The code below updates the name for the first named range. var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges(); if (namedRanges.length > 1) { namedRanges[0].setName("UpdatedNamedRange"); }
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
name | String | El nombre nuevo del rango con nombre. |
Devolvedor
NamedRange
: El rango cuyo nombre estableció la llamada
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRange(range)
Establece o actualiza el rango de este rango con nombre.
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
range | Range | El rango de la hoja de cálculo que se asocia con este rango con nombre. |
Devolvedor
NamedRange
: El rango con nombre para el que se estableció el rango de la hoja de cálculo
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets