在电子表格中创建、访问和修改命名的范围。命名范围是具有关联的字符串别名的范围。您可以通过表格界面下的数据>命名范围...菜单查看和修改这些范围。
方法
方法 | 返回类型 | 简介 |
---|---|---|
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()
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