Class RangeList

RentangDaftar

Kumpulan satu atau beberapa instance Range di sheet yang sama. Anda dapat menggunakan class ini untuk menerapkan operasi pada koleksi 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 setiap sel lagi.
check()	RangeList	Mengubah status kotak centang dalam rentang menjadi “ dicentang”.
clear()	RangeList	Menghapus rentang 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 di 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 kustom untuk dicentang dan string kosong untuk tidak dicentang.
insertCheckboxes(checkedValue, uncheckedValue)	RangeList	Menyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk status dicentang dan 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	Menetapkan latar belakang ke warna RGB yang diberikan.
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 setiap Range dalam daftar rentang atau tidak.
setWrap(isWrapEnabled)	RangeList	Tetapkan penggabungan 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.

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

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

Pulang pergi

RangeList — Daftar rentang aktif, untuk penyambungan.

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 setiap sel lagi.

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

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 dicentang atau tidak dicentang yang dikonfigurasi.

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 rentang konten, format, dan aturan validasi data untuk setiap Range dalam daftar rentang.

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 akan 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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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.

Parameter lanjutan

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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.

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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.

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 format teks untuk setiap rentang, tetapi tidak mereset aturan format angka apa pun.

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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.

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 di 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.

const 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 penyambungan.

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 kustom untuk dicentang dan string kosong untuk tidak dicentang. Menetapkan nilai setiap sel dalam rentang ke string kosong.

const 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 penyambungan.

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 kustom untuk status dicentang dan tidak dicentang. Menetapkan nilai setiap sel dalam rentang ke nilai kustom yang tidak dicentang.

const 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 yang tidak dicentang untuk validasi data kotak centang.

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 setiap sel, dan juga menghapus nilainya jika sel berisi nilai yang dicentang atau tidak dicentang.

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

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

const 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();

const 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 penyambungan.

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 direpresentasikan dalam notasi CSS; misalnya, '#ffffff' atau 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 mereset warna.

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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)

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

const sheet = SpreadsheetApp.getActiveSheet();
const 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 penyambungan.

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).

const sheet = SpreadsheetApp.getActiveSheet();
const 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 penyambungan.

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 diwakili dalam notasi CSS; misalnya, '#ffffff' atau 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 penyambungan.

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 direpresentasikan dalam notasi CSS; misalnya, '#ffffff' atau 'white'.

const sheet = SpreadsheetApp.getActiveSheet();
const 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'; nilai null mereset warna.

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 penyambungan.

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'.

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

Parameter

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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.

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

Parameter

Nama	Jenis	Deskripsi
size	Integer	Ukuran poin font.

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 font adalah 'italic' atau 'normal'.

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

Parameter

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 font adalah 'normal' atau 'bold'.

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

Parameter

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 penyambungan.

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.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 string.

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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'.

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

Parameter

Nama	Jenis	Deskripsi
alignment	String	Perataan, baik 'left', 'center', maupun 'normal'; nilai null mereset perataan.

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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.

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

Parameter

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 Sheets API.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 penyambungan.

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.

const sheet = SpreadsheetApp.getActiveSheet();
const 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 penyambungan.

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 akan disimpulkan, lalu ditetapkan.

// Sets right-to-left text direction each range in the range list.
const sheet = SpreadsheetApp.getActiveSheet();
const 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 akan disimpulkan sebelum setelan.

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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. Input sesuai dengan sudut antara orientasi teks standar dan orientasi yang diinginkan. Input nol menunjukkan bahwa teks disetel ke orientasi standar.

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

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45
// degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const 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 dari kiri ke kanan, sudut positif berada di arah berlawanan arah jarum jam.

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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. Nilai dapat berupa numerik, string, boolean, atau tanggal. Jika dimulai dengan '=', teks akan ditafsirkan sebagai formula.

const sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
const 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 penyambungan.

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.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment('middle');

Parameter

Nama	Jenis	Deskripsi
alignment	String	Perataan, baik 'top', 'middle', maupun 'bottom'; nilai null mereset perataan.

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 setiap Range dalam daftar rentang atau tidak. 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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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 penyambungan.

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 penggabungan teks untuk setiap Range dalam daftar rentang. Sel dengan penggabungan yang diaktifkan akan mengubah ukuran untuk menampilkan konten lengkapnya. Sel dengan penggabungan dinonaktifkan akan ditampilkan sebanyak mungkin dalam sel tanpa mengubah ukuran atau berjalan ke beberapa baris.

// Enable text wrap for the list of ranges.
const sheet = SpreadsheetApp.getActiveSheet();
const 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 penyambungan.

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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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 penyambungan.

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, serta mengurangi suburutan karakter spasi kosong yang tersisa menjadi satu spasi.

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

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

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

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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 dicentang atau tidak dicentang yang dikonfigurasi.

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

Pulang pergi

RangeList — Daftar rentang ini, untuk penyambungan.

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