Halaman ini diterjemahkan oleh Cloud Translation API.

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

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