Halaman ini diterjemahkan oleh Cloud Translation API.

Class NamedRange

Range yang memiliki nama dan ID untuk memungkinkan pengambilan nanti. Nama bukan harus unik; beberapa rentang berbeda di tab yang sama mungkin memiliki nama yang sama, mirip seperti di HTML. Sebaliknya, ID bersifat unik dalam tab, seperti ID di HTML. Setelah NamedRange ditambahkan ke tab, Anda tidak dapat mengubahnya, hanya dapat dihapus.

NamedRange dapat diakses oleh skrip apa pun yang mengakses tab. Untuk menghindari hal yang tidak diinginkan konflik antar skrip, pertimbangkan untuk memberi awalan pada nama rentang dengan string unik.

// Create a named range that includes every table in the active tab.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`getId()`	`String`	Mendapatkan ID `NamedRange` ini.
`getName()`	`String`	Mendapatkan nama `NamedRange` ini.
`getRange()`	`Range`	Mendapatkan rentang elemen yang terkait dengan `NamedRange` ini.
`remove()`	`void`	Menghapus `NamedRange` ini dari tab.

Dokumentasi mendetail

`getId()`

Mendapatkan ID NamedRange ini. ID bersifat unik dalam tab.

Pulang pergi

String — ID rentang, yang unik dalam tab.

`getName()`

Mendapatkan nama NamedRange ini. Nama belum tentu unik.

Pulang pergi

String — Nama rentang, yang belum tentu unik.

Otorisasi

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`getRange()`

Mendapatkan rentang elemen yang terkait dengan NamedRange ini.

Pulang pergi

Range — Rentang elemen yang terkait dengan nama dan ID.

Otorisasi

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents

`remove()`

Menghapus NamedRange ini dari tab. Metode ini tidak menghapus isi {i>range<i}; hanya akan menghapus referensi. Memanggil metode ini di NamedRange yang telah dihapus tidak berpengaruh.

Otorisasi

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

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents