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