Class NamedRange

NamedRange

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

Metode

MetodeJenis nilai 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.
const namedRanges = SpreadsheetApp.getActive().getNamedRanges();
for (let 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.
const namedRanges = SpreadsheetApp.getActiveSpreadsheet().getNamedRanges();
if (namedRanges.length > 1) {
  namedRanges[0].setName('UpdatedNamedRange');
}

Parameter

NamaJenisDeskripsi
nameStringNama baru 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 yang akan dikaitkan dengan rentang bernama ini.

Pulang pergi

NamedRange — rentang bernama yang rentang spreadsheet-nya 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