Class NamedRange

NamedRange

在試算表中建立、存取及修改已命名範圍。已命名範圍是指具有相關聯字串別名的範圍。您可以透過 Google 試算表 UI 的「Data」>「已命名範圍...」選單，查看及編輯資料範圍。

方法

方法	傳回類型	簡短說明
getName()	String	取得這個已命名範圍的名稱。
getRange()	Range	取得這個命名範圍參照的範圍。
remove()	void	刪除這個已命名範圍。
setName(name)	NamedRange	設定/更新已命名範圍的名稱。
setRange(range)	NamedRange	設定/更新這個已命名範圍的範圍。

內容詳盡的說明文件

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