Class RangeList

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

Metode

Metode	Jenis nilai yang ditampilkan	Deskripsi singkat
`activate()`	`RangeList`	Memilih daftar instance `Range`.
`breakApart()`	`RangeList`	Membagi semua sel yang digabungkan secara horizontal atau vertikal yang ada dalam daftar rentang menjadi sel individual 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` 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 dalam setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk yang dicentang dan string kosong untuk yang 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`	Menetapkan 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 penyelarasan vertikal untuk setiap `Range` dalam daftar rentang.
`setVerticalText(isVertical)`	`RangeList`	Menetapkan apakah akan menumpuk teks untuk sel bagi setiap `Range` dalam rentang daftar.
`setWrap(isWrapEnabled)`	`RangeList`	Tetapkan pelengkapan teks untuk setiap `Range` dalam daftar rentang.
`setWrapStrategy(strategy)`	`RangeList`	Menetapkan strategi pelengkapan 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: Cara ini memungkinkan Anda 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 penggabungan.

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

Membagi semua sel yang digabungkan secara horizontal atau vertikal yang ada dalam daftar rentang menjadi sel individual lagi.

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

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

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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

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 konten yang akan dihapus.
`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 dirangkaikan.

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

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

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 menghapus pemformatan teks untuk setiap rentang, tetapi tidak mereset aturan pemformatan angka.

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

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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

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.

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

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

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 tidak dicentang kustom.

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

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

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 ditampilkan 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` akan mereset warna.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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

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

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 ditampilkan 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 dirangkaikan.

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` akan mereset warna.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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. Family 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` akan mereset jenis font.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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` akan mereset gaya garis font.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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

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

Menetapkan 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, baik `'italic'` atau `'normal'`; nilai `null` akan mereset gaya font.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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` akan mereset ketebalan font.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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

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

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'`, atau `'normal'`; nilai `null` akan mereset perataan.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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

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

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

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 disimpulkan sebelum ditetapkan.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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 ditetapkan ke orientasi standar.

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

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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 '=', maka 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 dirangkaikan.

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 penyelarasan 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'`, atau `'bottom'`; nilai `null` akan mereset perataan.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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 bagi setiap Range dalam rentang daftar. Jika teks disusun 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 teks akan ditumpuk atau tidak.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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 pelengkapan teks untuk setiap Range dalam daftar rentang. Sel dengan fitur kemas yang diaktifkan akan diubah ukurannya untuk menampilkan seluruh kontennya. Sel dengan fitur pengepasan 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 mengemas teks atau tidak.

Pulang pergi

RangeList — Daftar rentang ini, untuk dirangkaikan.

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 pelengkapan 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 dirangkaikan.

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 setiap subsekuens karakter spasi kosong yang tersisa menjadi satu spasi.

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

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 dikonfigurasi, baik yang dicentang maupun tidak dicentang.

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

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

Class RangeList Tetap teratur dengan koleksi Simpan dan kategorikan konten berdasarkan preferensi Anda.

Metode

Dokumentasi mendetail

activate()

Pulang pergi

Otorisasi

breakApart()

Pulang pergi

Otorisasi

check()

Pulang pergi

Otorisasi

clear()

Pulang pergi

Otorisasi

clear(options)

Parameter

Parameter lanjutan

Pulang pergi

Otorisasi

clearContent()

Pulang pergi

Otorisasi

clearDataValidations()

Pulang pergi

Otorisasi

clearFormat()

Pulang pergi

Otorisasi

clearNote()

Pulang pergi

Otorisasi

getRanges()

Pulang pergi

Otorisasi

insertCheckboxes()

Pulang pergi

Otorisasi

insertCheckboxes(checkedValue)

Parameter

Pulang pergi

Otorisasi

insertCheckboxes(checkedValue, uncheckedValue)

Parameter

Pulang pergi

Otorisasi

removeCheckboxes()

Pulang pergi

Otorisasi

setBackground(color)

Parameter

Pulang pergi

Otorisasi

setBackgroundRGB(red, green, blue)

Parameter

Pulang pergi

Otorisasi

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

Parameter

Pulang pergi

Otorisasi

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

Parameter

Pulang pergi

Otorisasi

setFontColor(color)

Parameter

Pulang pergi

Otorisasi

setFontFamily(fontFamily)

Parameter

Pulang pergi

Otorisasi

setFontLine(fontLine)

Parameter

Pulang pergi

Otorisasi

setFontSize(size)

Parameter

Pulang pergi

Class RangeList

`activate()`

`breakApart()`

`check()`

`clear()`

`clear(options)`

`clearContent()`

`clearDataValidations()`

`clearFormat()`

`clearNote()`

`getRanges()`

`insertCheckboxes()`

`insertCheckboxes(checkedValue)`

`insertCheckboxes(checkedValue, uncheckedValue)`

`removeCheckboxes()`

`setBackground(color)`

`setBackgroundRGB(red, green, blue)`

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

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

`setFontColor(color)`

`setFontFamily(fontFamily)`

`setFontLine(fontLine)`

`setFontSize(size)`

`setFontStyle(fontStyle)`

`setFontWeight(fontWeight)`

`setFormula(formula)`

`setFormulaR1C1(formula)`

`setHorizontalAlignment(alignment)`

`setNote(note)`

`setNumberFormat(numberFormat)`

`setShowHyperlink(showHyperlink)`

`setTextDirection(direction)`

`setTextRotation(degrees)`

`setValue(value)`

`setVerticalAlignment(alignment)`

`setVerticalText(isVertical)`

`setWrap(isWrapEnabled)`

`setWrapStrategy(strategy)`

`trimWhitespace()`

`uncheck()`