Class NamedRange

Именованныйдиапазон

Создавайте, получайте доступ и изменяйте именованные диапазоны в электронной таблице. Именованные диапазоны — это диапазоны, которым присвоены псевдонимы строк. Их можно просматривать и редактировать через пользовательский интерфейс Таблиц в меню Данные > Именованные диапазоны....

Методы

Метод Тип возврата Краткое описание
getName() String Получает имя этого именованного диапазона.
getRange() Range Получает диапазон, на который ссылается этот именованный диапазон.
remove() void Удаляет этот именованный диапазон.
setName(name) NamedRange Устанавливает/обновляет имя именованного диапазона.
setRange(range) NamedRange Устанавливает/обновляет диапазон для этого именованного диапазона.

Подробная документация

getName()

Получает имя этого именованного диапазона.

Возвращаться

String — имя этого именованного диапазона.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

getRange()

Получает диапазон, на который ссылается этот именованный диапазон.

Возвращаться

Range — диапазон электронной таблицы, связанный с этим именованным диапазоном.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

remove()

Удаляет этот именованный диапазон. 

// 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();
}

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

setName(name)

Устанавливает/обновляет имя именованного диапазона. 

// The code below updates the name for the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName("UpdatedNamedRange");
}

Параметры

Имя Тип Описание
name String Новое имя именованного диапазона.

Возвращаться

NamedRange — диапазон, имя которого было задано вызовом.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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

setRange(range)

Устанавливает/обновляет диапазон для этого именованного диапазона.

Параметры

Имя Тип Описание
range Range Диапазон электронной таблицы, который необходимо связать с этим именованным диапазоном.

Возвращаться

NamedRange — именованный диапазон, для которого был установлен диапазон электронной таблицы.

Авторизация

Сценарии, использующие этот метод, требуют авторизации с одной или несколькими из следующих областей :

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