Class NamedRange

NamedRange

Range，具有名稱和 ID，方便日後擷取。名稱不一定會是唯一的，同一個分頁中的多個不同範圍可能會共用相同名稱，就像 HTML 中的類別一樣。相較之下，ID 在分頁中是唯一的，例如 HTML 中的 ID。NamedRange新增至分頁後就無法修改，只能移除。

任何存取分頁的指令碼都可以存取 NamedRange。為避免指令碼之間發生非預期的衝突，建議在範圍名稱加上獨一無二的字串前置字元。

// Create a named range that includes every table in the active tab.
const documentTab =
    DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.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()

取得與這個 NamedRange 相關聯的元素範圍。

回攻員

Range：與名稱和 ID 相關聯的元素範圍。

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

  • 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