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