Class NamedRange

NamedRange

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

Методы

Метод Тип возвращаемого значения Краткое описание
get Name() String Получает имя этого именованного диапазона.
get Range() Range Получает диапазон, на который ссылается этот именованный диапазон.
remove() void Удаляет этот именованный диапазон.
set Name(name) Named Range Устанавливает/обновляет имя именованного диапазона.
set Range(range) Named Range Устанавливает/обновляет диапазон для этого именованного диапазона.

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

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