Se usó la API de Cloud Translation para traducir esta página.

Class NamedRange

Permite crear, acceder y modificar rangos con nombre en una hoja de cálculo. Los rangos con nombre son rangos alias de cadena asociados. Se pueden ver y editar en la IU de Hojas de cálculo en la pestaña Datos > Menú 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.

Volver

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.

Volver

Range: Es 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.

Volver

NamedRange: Es 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 asociará a este rango con nombre.

Volver

NamedRange: Es 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