Class NamedRange

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

Range , имеющий имя и идентификатор, позволяющий его позднее получить. Имена не обязательно уникальны; несколько разных диапазонов в одном документе могут иметь одно и то же имя, как класс в HTML. Идентификаторы, напротив, уникальны внутри документа, как идентификатор в HTML. После добавления NamedRange в документ его нельзя изменить, а только удалить.

Доступ NamedRange может быть получен любым сценарием, обращающимся к документу. Чтобы избежать непреднамеренных конфликтов между сценариями, рассмотрите возможность добавления к именам диапазонов префиксов с уникальной строкой.

// Create a named range that includes every table in the document.
var doc = DocumentApp.getActiveDocument();
var rangeBuilder = doc.newRange();
var tables = doc.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

Методы

Метод Тип возврата Краткое описание
getId() String Получает идентификатор этого NamedRange .
getName() String Получает имя этого NamedRange .
getRange() Range Получает диапазон элементов, связанных с этим NamedRange .
remove() void Удаляет этот NamedRange из документа.

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

getId()

Получает идентификатор этого NamedRange . Идентификатор уникален в пределах документа.

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

String — идентификатор диапазона, уникальный в пределах документа.


getName()

Получает имя этого NamedRange . Имя не обязательно уникально.

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

String — имя диапазона, которое не обязательно уникально.

Авторизация

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

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

getRange()

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

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

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

Авторизация

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

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

remove()

Удаляет этот NamedRange из документа. Этот метод не удаляет содержимое диапазона; это просто удаляет ссылку. Вызов этого метода для NamedRange , который уже был удален, не имеет никакого эффекта.

Авторизация

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

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