具有名称和 ID（以便稍后检索）的 Range。名称不必是唯一的；同一文档中的多个不同范围可以共用同一个名称，这与 HTML 中的类非常相似。相比之下，ID 在文档中是唯一的，就像 HTML 中的 ID 一样。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 的 ID。 |
getName() | String | 获取此 NamedRange 的名称。 |
getRange() | Range | 获取与此 NamedRange 关联的元素范围。 |
remove() | void | 从文档中移除此 NamedRange。 |
详细文档
getId()
获取此 NamedRange 的 ID。此 ID 在文档中是唯一的。
弃踢回攻
String - 范围的 ID，在文档中是唯一的
getName()
获取此 NamedRange 的名称。该名称不一定是唯一的。
弃踢回攻
String - 范围的名称，不一定是唯一的
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
getRange()
remove()
从文档中移除此 NamedRange。此方法不会删除范围的内容，而只是移除引用。对已移除的 NamedRange 调用此方法不会产生任何效果。
授权
使用此方法的脚本需要获得以下一个或多个范围的授权：
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents