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

Class NamedRange

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 para 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 hoja de cálculo asociado con 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 se estableció en 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 para este rango con nombre.

Parámetros

Nombre	Tipo	Descripción
`range`	`Range`	El rango de hojas de cálculo que se asociará con este rango con nombre.

Volver

NamedRange: El rango con nombre para el que se configuró 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