Class NamedRange

NamedRange

Membuat, mengakses, dan mengubah rentang bernama dalam spreadsheet. Rentang bernama adalah rentang yang memiliki alias string yang terkait. Data tersebut dapat dilihat dan diedit melalui UI Spreadsheet di bagian Data > Rentang bernama....

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
getName()StringMendapatkan nama rentang bernama ini.
getRange()RangeMendapatkan rentang yang dirujuk oleh rentang bernama ini.
remove()voidMenghapus rentang bernama ini.
setName(name)NamedRangeMenetapkan/memperbarui nama rentang bernama.
setRange(range)NamedRangeMenetapkan/memperbarui rentang untuk rentang bernama ini.

Dokumentasi mendetail

getName()

Mendapatkan nama rentang bernama ini.

Pulang pergi

String — nama rentang bernama ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange()

Mendapatkan rentang yang dirujuk oleh rentang bernama ini.

Pulang pergi

Range — rentang spreadsheet yang terkait dengan rentang bernama ini

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

Menghapus rentang bernama ini.

// 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();
}

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setName(name)

Menetapkan/memperbarui nama rentang bernama.

// The code below updates the name for the first named range.
var namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName("UpdatedNamedRange");
}

Parameter

NamaJenisDeskripsi
nameStringNama baru dari rentang bernama.

Pulang pergi

NamedRange — rentang yang namanya ditetapkan oleh panggilan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setRange(range)

Menetapkan/memperbarui rentang untuk rentang bernama ini.

Parameter

NamaJenisDeskripsi
rangeRangeRentang spreadsheet untuk dikaitkan dengan rentang bernama ini.

Pulang pergi

NamedRange — rentang bernama yang rentang spreadsheetnya ditetapkan

Otorisasi

Skrip yang menggunakan metode ini memerlukan otorisasi dengan satu atau beberapa cakupan berikut:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets