Class NamedRange

Rango con nombre

Crear, acceder y modificar rangos con nombre en una hoja de cálculo Los rangos con nombre son rangos que tienen alias de cadenas asociados. Se pueden ver y editar a través de la IU de Hojas de cálculo en el menú Datos > Rangos nombrados….

MétodoTipo de datos que se muestraDescripción breve
getName()StringObtiene el nombre de este rango con nombre.
getRange()RangeObtiene el rango al que hace referencia este rango con nombre.
remove()voidBorra este rango con nombre.
setName(name)NamedRangeEstablece o actualiza el nombre del rango con nombre.
setRange(range)NamedRangeEstablece 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 ámbitos:

  • 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 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 ámbitos:

  • 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.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let 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 ámbitos:

  • 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.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges
[0].setName('UpdatedNamedRange');
}

Parámetros

NombreTipoDescripción
nameStringEs el nombre nuevo del rango con nombre.

Volver

NamedRange: Es el rango cuyo nombre se configuró con la llamada.

Autorización

Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes ámbitos:

  • 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

NombreTipoDescripción
rangeRangeEs el rango de la hoja de cálculo que se asociará con 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 ámbitos:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets