Class RangeList

RangeList

Kumpulan satu atau beberapa instance Range dalam sheet yang sama. Anda dapat menggunakan kelas ini untuk menerapkan operasi pada kumpulan rentang atau sel yang tidak berdekatan.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
activate()	RangeList	Memilih daftar instance Range.
breakApart()	RangeList	Pisahkan semua sel yang digabungkan secara horizontal atau vertikal yang terdapat dalam daftar rentang menjadi sel individu lagi.
check()	RangeList	Mengubah status kotak centang dalam rentang menjadi "dicentang".
clear()	RangeList	Menghapus berbagai konten, format, dan aturan validasi data untuk setiap Range dalam daftar rentang.
clear(options)	RangeList	Menghapus rentang konten, format, aturan validasi data, dan komentar, seperti yang ditentukan dengan opsi yang diberikan.
clearContent()	RangeList	Menghapus konten setiap Range dalam daftar rentang, tanpa mengubah format.
clearDataValidations()	RangeList	Menghapus aturan validasi data untuk setiap Range dalam daftar rentang.
clearFormat()	RangeList	Menghapus pemformatan teks untuk setiap Range dalam daftar rentang.
clearNote()	RangeList	Menghapus catatan untuk setiap Range dalam daftar rentang.
getRanges()	Range[]	Menampilkan daftar satu atau beberapa instance Range dalam sheet yang sama.
insertCheckboxes()	RangeList	Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan true untuk dicentang dan false untuk tidak dicentang.
insertCheckboxes(checkedValue)	RangeList	Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai khusus untuk kotak centang dan {i>string<i} kosong untuk tidak dicentang.
insertCheckboxes(checkedValue, uncheckedValue)	RangeList	Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai khusus untuk kotak yang dicentang dan status tidak dicentang.
removeCheckboxes()	RangeList	Menghapus semua kotak centang dari rentang.
setBackground(color)	RangeList	Menetapkan warna latar belakang untuk setiap Range dalam daftar rentang.
setBackgroundRGB(red, green, blue)	RangeList	Menyetel latar belakang ke warna RGB yang ditentukan.
setBorder(top, left, bottom, right, vertical, horizontal)	RangeList	Menetapkan properti batas untuk setiap Range dalam daftar rentang.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)	RangeList	Menetapkan properti batas dengan warna dan/atau gaya untuk setiap Range dalam daftar rentang.
setFontColor(color)	RangeList	Menetapkan warna font untuk setiap Range dalam daftar rentang.
setFontFamily(fontFamily)	RangeList	Menetapkan jenis font untuk setiap Range dalam daftar rentang.
setFontLine(fontLine)	RangeList	Menetapkan gaya garis font untuk setiap Range dalam daftar rentang.
setFontSize(size)	RangeList	Menetapkan ukuran font (dalam poin) untuk setiap Range dalam daftar rentang.
setFontStyle(fontStyle)	RangeList	Tetapkan gaya font untuk setiap Range dalam daftar rentang.
setFontWeight(fontWeight)	RangeList	Tetapkan ketebalan font untuk setiap Range dalam daftar rentang.
setFormula(formula)	RangeList	Memperbarui formula untuk setiap Range dalam daftar rentang.
setFormulaR1C1(formula)	RangeList	Memperbarui formula untuk setiap Range dalam daftar rentang.
setHorizontalAlignment(alignment)	RangeList	Tetapkan perataan horizontal untuk setiap Range dalam daftar rentang.
setNote(note)	RangeList	Menetapkan teks catatan untuk setiap Range dalam daftar rentang.
setNumberFormat(numberFormat)	RangeList	Menetapkan format angka atau tanggal untuk setiap Range dalam daftar rentang.
setShowHyperlink(showHyperlink)	RangeList	Menetapkan apakah setiap Range dalam daftar rentang harus menampilkan hyperlink atau tidak.
setTextDirection(direction)	RangeList	Menetapkan arah teks untuk sel di setiap Range dalam daftar rentang.
setTextRotation(degrees)	RangeList	Menetapkan setelan rotasi teks untuk sel di setiap Range dalam daftar rentang.
setValue(value)	RangeList	Menetapkan nilai untuk setiap Range dalam daftar rentang.
setVerticalAlignment(alignment)	RangeList	Tetapkan perataan vertikal untuk setiap Range dalam daftar rentang.
setVerticalText(isVertical)	RangeList	Menetapkan apakah akan menumpuk teks untuk sel untuk tiap Range dalam rentang atau tidak daftar.
setWrap(isWrapEnabled)	RangeList	Tetapkan pengemasan teks untuk setiap Range dalam daftar rentang.
setWrapStrategy(strategy)	RangeList	Menetapkan strategi penggabungan teks untuk setiap Range dalam daftar rentang.
trimWhitespace()	RangeList	Memangkas spasi kosong (seperti spasi, tab, atau baris baru) di setiap sel dalam daftar rentang ini.
uncheck()	RangeList	Mengubah status kotak centang dalam rentang menjadi “tidak dicentang”.

Dokumentasi mendetail

activate()

Memilih daftar instance Range. Rentang terakhir dalam daftar ditetapkan sebagai active range.

Catatan: Tindakan ini memberikan cara untuk memilih beberapa rentang sekaligus.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.activate();

var selection = sheet.getSelection();
// Current cell: B2
var currentCell = selection.getCurrentCell();
// Active range: B2:C4
var activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
var activeRangeList = selection.getActiveRangeList();

Pulang pergi

RangeList — Daftar rentang aktif, untuk perantaian.

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

---

breakApart()

Pisahkan semua sel yang digabungkan secara horizontal atau vertikal yang terdapat dalam daftar rentang menjadi sel individu lagi.

Memanggil fungsi ini pada daftar rentang sama dengan memilih serangkaian rentang dan memilih tombol Format > Gabungkan > Pisahkan item menu Spreadsheet.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.breakApart();

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

check()

Mengubah status kotak centang dalam rentang menjadi "dicentang". Mengabaikan sel dalam rentang yang saat ini tidak berisi nilai yang dicentang atau tidak dicentang, yang telah dikonfigurasi.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the ranges D4 and E6 to 'checked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

clear()

Menghapus berbagai konten, format, dan aturan validasi data untuk setiap Range dalam daftar rentang.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear();

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

clear(options)

Menghapus rentang konten, format, aturan validasi data, dan komentar, seperti yang ditentukan dengan opsi yang diberikan. Secara default, semua data dihapus.

// The code below clears the contents of the following ranges A:A and C:C in the active sheet,
// but preserves the format, data validation rules, and comments.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

Parameter

Nama	Jenis	Deskripsi
options	Object	Objek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini.

Parameter lanjutan

Nama	Jenis	Deskripsi
commentsOnly	Boolean	Apakah hanya menghapus komentar.
contentsOnly	Boolean	Apakah akan menghapus konten saja.
formatOnly	Boolean	Apakah akan menghapus format saja; perhatikan bahwa menghapus format ini juga menghapus aturan validasi data.
validationsOnly	Boolean	Apakah akan menghapus hanya aturan validasi data.
skipFilteredRows	Boolean	Apakah ingin menghindari penghapusan baris yang difilter.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

clearContent()

Menghapus konten setiap Range dalam daftar rentang, tanpa mengubah format.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

clearDataValidations()

Menghapus aturan validasi data untuk setiap Range dalam daftar rentang.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

clearFormat()

Menghapus pemformatan teks untuk setiap Range dalam daftar rentang.

Tindakan ini akan menghapus pemformatan teks untuk setiap rentang, tetapi tidak mereset aturan pemformatan angka.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

clearNote()

Menghapus catatan untuk setiap Range dalam daftar rentang.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearNote();

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

getRanges()

Menampilkan daftar satu atau beberapa instance Range dalam sheet yang sama.

Pulang pergi

Range[] — Daftar rentang.

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

---

insertCheckboxes()

Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan true untuk dicentang dan false untuk tidak dicentang. Menetapkan nilai semua sel dalam rentang ke false.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to
// 'false'.
rangeList.insertCheckboxes();

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

insertCheckboxes(checkedValue)

Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai khusus untuk kotak centang dan {i>string<i} kosong untuk tidak dicentang. Menetapkan nilai setiap sel dalam rentang ke string kosong.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the ranges D4 and
// E6 to the empty string.
rangeList.insertCheckboxes('yes');

Parameter

Nama	Jenis	Deskripsi
checkedValue	Object	Nilai yang dicentang untuk validasi data kotak centang.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

insertCheckboxes(checkedValue, uncheckedValue)

Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai khusus untuk kotak yang dicentang dan status tidak dicentang. Menetapkan nilai setiap sel dalam rentang ke nilai kustom yang tidak dicentang.

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

Parameter

Nama	Jenis	Deskripsi
checkedValue	Object	Nilai yang dicentang untuk validasi data kotak centang.
uncheckedValue	Object	Nilai untuk validasi data kotak centang tidak dicentang.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

removeCheckboxes()

Menghapus semua kotak centang dari rentang. Menghapus validasi data dari setiap sel, dan juga menghapus nilainya jika sel berisi nilai yang dicentang atau tidak dicentang.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

var rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their value.
rangeList1.removeCheckboxes();

var rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear their value.
rangeList2.removeCheckboxes();

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setBackground(color)

Menetapkan warna latar belakang untuk setiap Range dalam daftar rentang. Warna diwakili dalam dalam notasi CSS; misalnya, '#ffffff' atau 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setBackground('red');

Parameter

Nama	Jenis	Deskripsi
color	String	Kode warna latar belakang dalam notasi CSS seperti '#ffffff' atau 'white'; nilai null akan mereset warna.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setBackgroundRGB(red, green, blue)

Menyetel latar belakang ke warna RGB yang ditentukan. Ini adalah wrapper praktis di sekitar panggilan setBackground(color).

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

Parameter

Nama	Jenis	Deskripsi
red	Integer	Nilai merah dalam notasi RGB.
green	Integer	Nilai hijau dalam notasi RGB.
blue	Integer	Nilai biru dalam notasi RGB.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setBorder(top, left, bottom, right, vertical, horizontal)

Menetapkan properti batas untuk setiap Range dalam daftar rentang. Nilai yang valid adalah true (aktif), false (nonaktif), dan null (tidak ada perubahan).

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves the left and
// right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

Parameter

Nama	Jenis	Deskripsi
top	Boolean	true untuk batas, false untuk tidak ada, null untuk tidak ada perubahan.
left	Boolean	true untuk batas, false untuk tidak ada, null untuk tidak ada perubahan.
bottom	Boolean	true untuk batas, false untuk tidak ada, null untuk tidak ada perubahan.
right	Boolean	true untuk batas, false untuk tidak ada, null untuk tidak ada perubahan.
vertical	Boolean	true untuk batas vertikal internal, false untuk tidak ada, null untuk tidak ada perubahan.
horizontal	Boolean	true untuk batas horizontal internal, false untuk tidak ada, null untuk tidak ada perubahan.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

Menetapkan properti batas dengan warna dan/atau gaya untuk setiap Range dalam daftar rentang. Nilai yang valid adalah true (aktif), false (nonaktif), dan null (tidak ada perubahan). Warna adalah direpresentasikan dalam notasi CSS; misalnya, '#ffffff' atau 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged of the ranges
// A2:B4 and C1:D4. Also sets the color to 'red', and the border to 'DASHED'.
rangeList.setBorder(
    true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);

Parameter

Nama	Jenis	Deskripsi
top	Boolean	true untuk batas, false untuk tidak ada, null untuk tidak ada perubahan.
left	Boolean	true untuk batas, false untuk tidak ada, null untuk tidak ada perubahan.
bottom	Boolean	true untuk batas, false untuk tidak ada, null untuk tidak ada perubahan.
right	Boolean	true untuk batas, false untuk tidak ada, null untuk tidak ada perubahan.
vertical	Boolean	true untuk batas vertikal internal, false untuk tidak ada, null untuk tidak ada perubahan.
horizontal	Boolean	true untuk batas horizontal internal, false untuk tidak ada, null untuk tidak ada perubahan.
color	String	Warna batas dalam notasi CSS seperti '#ffffff' atau 'white', null untuk warna default (hitam).
style	BorderStyle	Gaya untuk batas, null untuk gaya default (solid).

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setFontColor(color)

Menetapkan warna font untuk setiap Range dalam daftar rentang. Warna diwakili dalam CSS notasi; misalnya, '#ffffff' atau 'white'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontColor('red');

Parameter

Nama	Jenis	Deskripsi
color	String	Warna font dalam notasi CSS seperti '#ffffff' atau 'white'; suatu Nilai null mereset warna.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setFontFamily(fontFamily)

Menetapkan jenis font untuk setiap Range dalam daftar rentang. Jenis font dijelaskan oleh ID string seperti Arial atau Roboto.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontFamily('Roboto');

Parameter

Nama	Jenis	Deskripsi
fontFamily	String	Jenis font yang akan ditetapkan; nilai null mereset jenis font.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setFontLine(fontLine)

Menetapkan gaya garis font untuk setiap Range dalam daftar rentang. Opsi gaya garis adalah 'underline', 'line-through', atau 'none'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontLine('line-through');

Parameter

Nama	Jenis	Deskripsi
fontLine	String	Gaya garis font, 'underline', 'line-through', atau 'none'; nilai null mereset gaya garis font.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setFontSize(size)

Menetapkan ukuran font (dalam poin) untuk setiap Range dalam daftar rentang.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontSize(20);

Parameter

Nama	Jenis	Deskripsi
size	Integer	Ukuran {i>font<i}.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setFontStyle(fontStyle)

Tetapkan gaya font untuk setiap Range dalam daftar rentang. Opsi gaya {i>font<i} adalah 'italic' atau 'normal'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontStyle("italic");

Parameter

Nama	Jenis	Deskripsi
fontStyle	String	Gaya font, baik 'italic' atau 'normal'; null nilai menyetel ulang gaya font.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setFontWeight(fontWeight)

Tetapkan ketebalan font untuk setiap Range dalam daftar rentang. Opsi ketebalan {i>font<i} adalah 'normal' atau 'bold'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontWeight('bold');

Parameter

Nama	Jenis	Deskripsi
fontWeight	String	Ketebalan font, baik 'bold' atau 'normal'; null nilai mengatur ulang ketebalan font.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setFormula(formula)

Memperbarui formula untuk setiap Range dalam daftar rentang. Formula yang diberikan harus dalam Notasi A1.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

Parameter

Nama	Jenis	Deskripsi
formula	String	String yang mewakili formula yang akan ditetapkan.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setFormulaR1C1(formula)

Memperbarui formula untuk setiap Range dalam daftar rentang. Formula yang diberikan harus dalam Notasi R1C1.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

Parameter

Nama	Jenis	Deskripsi
formula	String	Formula {i>string<i}.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setHorizontalAlignment(alignment)

Tetapkan perataan horizontal untuk setiap Range dalam daftar rentang. Opsi perataan adalah 'left', 'center', atau 'right'.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setHorizontalAlignment("center");

Parameter

Nama	Jenis	Deskripsi
alignment	String	Perataan, baik 'left', 'center', atau 'normal'; suatu Nilai null mereset perataan.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setNote(note)

Menetapkan teks catatan untuk setiap Range dalam daftar rentang.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

Parameter

Nama	Jenis	Deskripsi
note	String	Teks catatan yang akan diatur; nilai null akan menghapus catatan.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setNumberFormat(numberFormat)

Menetapkan format angka atau tanggal untuk setiap Range dalam daftar rentang.

Pola pemformatan yang diterima dijelaskan dalam panduan pemformatan tanggal dan angka API Spreadsheet.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

Parameter

Nama	Jenis	Deskripsi
numberFormat	String	String format angka.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setShowHyperlink(showHyperlink)

Menetapkan apakah setiap Range dalam daftar rentang harus menampilkan hyperlink atau tidak.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Show hyperlinks for all the ranges.
rangeList.setShowHyperlink(true);

Parameter

Nama	Jenis	Deskripsi
showHyperlink	Boolean	Apakah akan menampilkan hyperlink atau tidak.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setTextDirection(direction)

Menetapkan arah teks untuk sel di setiap Range dalam daftar rentang. Jika arah yang ditentukan adalah null, arah disimpulkan, lalu disetel.

// Sets right-to-left text direction each range in the range list.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parameter

Nama	Jenis	Deskripsi
direction	TextDirection	Arah teks yang diinginkan; jika null arah disimpulkan sebelum deskripsi tempat.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setTextRotation(degrees)

Menetapkan setelan rotasi teks untuk sel di setiap Range dalam daftar rentang. Tujuan sesuai dengan sudut antara orientasi teks standar dan orientasi. Input nol menunjukkan bahwa teks disetel ke orientasi standar.

Untuk teks arah kiri ke kanan, sudut positif adalah berlawanan arah jarum jam, sedangkan untuk kanan ke kiri mereka adalah searah jarum jam.

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

Parameter

Nama	Jenis	Deskripsi
degrees	Integer	Sudut yang diinginkan antara orientasi standar dan orientasi yang diinginkan. Untuk teks kiri ke kanan, sudut positif dalam arah berlawanan.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setValue(value)

Menetapkan nilai untuk setiap Range dalam daftar rentang. Nilainya bisa numerik, {i>string<i}, boolean atau tanggal. Jika diawali dengan '=' hal itu ditafsirkan sebagai rumus.

var sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

Parameter

Nama	Jenis	Deskripsi
value	Object	Nilai untuk rentang.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setVerticalAlignment(alignment)

Tetapkan perataan vertikal untuk setiap Range dalam daftar rentang. Opsi perataan adalah 'top', 'middle', atau 'bottom'.

// Sets the vertical alignment to middle for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment("middle");

Parameter

Nama	Jenis	Deskripsi
alignment	String	Perataan, baik 'top', 'middle', atau 'bottom'; suatu Nilai null mereset perataan.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setVerticalText(isVertical)

Menetapkan apakah akan menumpuk teks untuk sel untuk tiap Range dalam rentang atau tidak daftar. Jika teks ditumpuk secara vertikal, setelan rotasi teks derajat akan diabaikan.

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

Parameter

Nama	Jenis	Deskripsi
isVertical	Boolean	Apakah akan menumpuk teks atau tidak.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setWrap(isWrapEnabled)

Tetapkan pengemasan teks untuk setiap Range dalam daftar rentang. Sel dengan perubahan ukuran diaktifkan untuk menampilkan konten lengkap mereka. Sel dengan status wrap-nya nonaktif menampilkan sebanyak mungkin dalam sel tanpa mengubah ukuran atau berjalan ke beberapa baris.

// Enable text wrap for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

Parameter

Nama	Jenis	Deskripsi
isWrapEnabled	Boolean	Apakah akan menggabungkan teks atau tidak.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

setWrapStrategy(strategy)

Menetapkan strategi penggabungan teks untuk setiap Range dalam daftar rentang.

// Sets the list of ranges to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parameter

Nama	Jenis	Deskripsi
strategy	WrapStrategy	Strategi penggabungan yang diinginkan.

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

---

trimWhitespace()

Memangkas spasi kosong (seperti spasi, tab, atau baris baru) di setiap sel dalam daftar rentang ini. Menghapus semua spasi kosong dari awal dan akhir teks setiap sel, dan mengurangi suburutan karakter spasi kosong yang tersisa ke satu spasi.

Catatan: Jika hasil teks yang dipangkas diawali dengan '+' atau '=' teks, teks tetap sebagai nilai string dan tidak ditafsirkan sebagai formula.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)']);

var rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
rangeList.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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

Lihat juga

• Range.trimWhitespace()

---

uncheck()

Mengubah status kotak centang dalam rentang menjadi “tidak dicentang”. Mengabaikan sel dalam rentang yang saat ini tidak berisi nilai yang dicentang atau tidak dicentang, yang telah dikonfigurasi.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the ranges D4 and E6 to 'unchecked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

Pulang pergi

RangeList — Daftar rentang ini, untuk perantaian.

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