Halaman ini diterjemahkan oleh Cloud Translation API.

Class RangeList

Kumpulan satu atau beberapa instance Range di sheet yang sama. Anda dapat menggunakan class ini untuk menerapkan operasi pada koleksi sel atau rentang yang tidak berdekatan.

Metode

Metode	Jenis hasil yang ditampilkan	Deskripsi singkat
`activate()`	`RangeList`	Memilih daftar instance `Range`.
`breakApart()`	`RangeList`	Selubungkan semua sel yang digabungkan secara horizontal atau vertikal yang ada dalam daftar rentang menjadi sel tunggal.
`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 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 kotak yang dicentang dan string kosong untuk tidak dicentang.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Menyisipkan kotak centang ke dalam setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk status yang 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 titik) untuk setiap `Range` dalam daftar rentang.
`setFontStyle(fontStyle)`	`RangeList`	Setel 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`	Setel 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 akan menampilkan hyperlink atau tidak.
`setTextDirection(direction)`	`RangeList`	Menetapkan arah teks untuk sel di setiap `Range` dalam daftar rentang.
`setTextRotation(degrees)`	`RangeList`	Menetapkan pengaturan rotasi teks untuk sel dalam 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 menempatkan teks untuk sel di setiap `Range` dalam daftar rentang atau tidak.
`setWrap(isWrapEnabled)`	`RangeList`	Setel 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: Hal ini memberikan cara untuk memilih beberapa rentang dalam jumlah banyak.

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

Return

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()`

Selubungkan semua sel yang digabungkan secara horizontal atau vertikal yang ada dalam daftar rentang menjadi sel tunggal.

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

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

Return

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

Return

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

Return

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

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

Parameter lanjutan

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

Return

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

Return

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

Return

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 apa pun.

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

Return

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

Return

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 di sheet yang sama.

Return

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

Return

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 kustom untuk kotak yang dicentang dan string 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

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

Return

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 dalam setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk status yang dicentang dan 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

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

Return

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

Return

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

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

Parameter

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

Return

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

Menetapkan latar belakang ke warna RGB yang diberikan. 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

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

Return

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

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

Return

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 diwakili 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

Name	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 (padat).

Return

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

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

Parameter

Name	Jenis	Deskripsi
`color`	`String`	Warna font dalam notasi CSS, seperti `'#ffffff'` atau `'white'`; nilai `null` akan mereset warna.

Return

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

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

Return

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

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

Return

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 titik) untuk setiap Range dalam daftar rentang.

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

Parameter

Name	Jenis	Deskripsi
`size`	`Integer`	Ukuran titik font.

Return

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

Setel gaya font untuk setiap Range dalam daftar rentang. Opsi gaya font adalah 'italic' atau 'normal'.

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

Parameter

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

Return

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

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

Parameter

Name	Jenis	Deskripsi
`fontWeight`	`String`	Ketebalan font, baik `'bold'` maupun `'normal'`; nilai `null` akan mereset ketebalan font.

Return

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

Name	Jenis	Deskripsi
`formula`	`String`	String yang mewakili formula yang akan ditetapkan.

Return

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

Name	Jenis	Deskripsi
`formula`	`String`	Formula string.

Return

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

Setel 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

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

Return

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

Name	Jenis	Deskripsi
`note`	`String`	Teks catatan yang akan disetel; nilai `null` akan menghapus catatan.

Return

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

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

Name	Jenis	Deskripsi
`numberFormat`	`String`	String format angka.

Return

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 akan 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

Name	Jenis	Deskripsi
`showHyperlink`	`Boolean`	Menunjukkan apakah hyperlink ditampilkan atau tidak.

Return

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

// 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

Name	Jenis	Deskripsi
`direction`	`TextDirection`	Arah teks yang diinginkan; jika `null`, arahnya disimpulkan sebelum setelan.

Return

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 pengaturan rotasi teks untuk sel dalam setiap Range dalam daftar rentang. Input ini sesuai dengan sudut antara orientasi teks standar dan orientasi yang diinginkan. Input nol menunjukkan bahwa teks telah disetel ke orientasi standar.

Untuk arah teks kiri ke kanan, sudut positif berlawanan arah jarum jam, sedangkan kanan ke kiri berlawanan arah 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

Name	Jenis	Deskripsi
`degrees`	`Integer`	Sudut yang diinginkan antara orientasi standar dan orientasi yang diinginkan. Untuk teks kiri ke kanan, sudut positif berlawanan arah jarum jam.

Return

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 dapat berupa numerik, string, boolean, atau tanggal. Jika diawali dengan '=' hal tersebut ditafsirkan sebagai formula.

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

Name	Jenis	Deskripsi
`value`	`Object`	Nilai untuk rentang.

Return

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

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

Return

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 menempatkan teks untuk sel di setiap Range dalam daftar rentang atau tidak. Jika teks ditumpuk secara vertikal, pengaturan 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

Name	Jenis	Deskripsi
`isVertical`	`Boolean`	Apakah akan menumpuk teks atau tidak.

Return

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

Setel penggabungan teks untuk setiap Range dalam daftar rentang. Sel dengan wrap yang diaktifkan untuk mengubah ukuran untuk menampilkan konten lengkapnya. Sel dengan tampilan yang dinonaktifkan akan ditampilkan sebanyak mungkin di dalam sel tanpa mengubah ukuran atau menjalankannya 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

Name	Jenis	Deskripsi
`isWrapEnabled`	`Boolean`	Membungkus teks atau tidak.

Return

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

Name	Jenis	Deskripsi
`strategy`	`WrapStrategy`	Strategi penggabungan yang diinginkan.

Return

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 setiap teks sel, serta mengurangi setiap penggantian karakter spasi kosong yang tersisa menjadi 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)']

Return

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

Return

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