Kumpulan satu atau beberapa instance Range
dalam sheet yang sama. Anda dapat menggunakan class ini untuk menerapkan operasi pada koleksi rentang atau sel yang tidak berdekatan.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
activate() | RangeList | Memilih daftar instance Range . |
breakApart() | RangeList | Pisahkan semua sel yang digabungkan secara horizontal atau vertikal yang ada dalam daftar rentang menjadi kembali setiap sel. |
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 formatnya. |
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 yang 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 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 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 baris 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 bagi setiap Range dalam daftar
rentang atau tidak. |
setWrap(isWrapEnabled) | RangeList | Tetapkan penggabungan teks untuk setiap Range dalam daftar rentang. |
setWrapStrategy(strategy) | RangeList | Menetapkan strategi penggabungan teks untuk setiap Range dalam daftar rentang. |
trimWhitespace() | RangeList | Memangkas spasi kosong (seperti spasi, tab, atau baris baru) di setiap sel dalam daftar rentang ini. |
uncheck() | RangeList | Mengubah status kotak centang dalam rentang menjadi “tidak dicentang”. |
Dokumentasi mendetail
activate()
Memilih daftar instance Range
. Rentang terakhir dalam daftar ditetapkan sebagai active range
.
Catatan: Cara ini memungkinkan Anda 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();
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()
Pisahkan semua sel yang digabungkan secara horizontal atau vertikal yang ada dalam daftar rentang menjadi kembali setiap sel.
Memanggil fungsi ini pada daftar rentang sama dengan memilih sekumpulan rentang dan memilih item menu Format > Merge > Unmerge Spreadsheet.
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 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 hanya akan menghapus konten. |
formatOnly | Boolean | Apakah akan menghapus format saja; perhatikan bahwa menghapus format juga akan menghapus aturan validasi data. |
validationsOnly | Boolean | Apakah hanya akan menghapus aturan validasi data. |
skipFilteredRows | Boolean | Apakah ingin menghindari penghapusan baris yang difilter. |
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 formatnya.
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
dalam 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 yang 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 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.
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. |
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
Nama | Jenis | Deskripsi |
---|---|---|
checkedValue | Object | Nilai yang dicentang untuk validasi data kotak centang. |
uncheckedValue | Object | Nilai yang tidak 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
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
Nama | Jenis | Deskripsi |
---|---|---|
color | String | Kode warna latar belakang dalam notasi CSS seperti '#ffffff' atau 'white' ; nilai null 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 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. |
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
Nama | Jenis | Deskripsi |
---|---|---|
top | Boolean | true untuk batas, false untuk tidak ada, null jika tidak ada perubahan. |
left | Boolean | true untuk batas, false untuk tidak ada, null jika tidak ada perubahan. |
bottom | Boolean | true untuk batas, false untuk tidak ada, null jika tidak ada perubahan. |
right | Boolean | true untuk batas, false untuk tidak ada, null jika tidak ada perubahan. |
vertical | Boolean | true untuk batas vertikal internal, false untuk tidak ada, null jika tidak ada perubahan. |
horizontal | Boolean | true untuk batas horizontal internal, false untuk tidak ada, null jika 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
Nama | Jenis | Deskripsi |
---|---|---|
top | Boolean | true untuk batas, false untuk tidak ada, null jika tidak ada perubahan. |
left | Boolean | true untuk batas, false untuk tidak ada, null jika tidak ada perubahan. |
bottom | Boolean | true untuk batas, false untuk tidak ada, null jika tidak ada perubahan. |
right | Boolean | true untuk batas, false untuk tidak ada, null jika tidak ada perubahan. |
vertical | Boolean | true untuk batas vertikal internal, false untuk tidak ada, null jika tidak ada perubahan. |
horizontal | Boolean | true untuk batas horizontal internal, false untuk tidak ada, null jika 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). |
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
Nama | Jenis | Deskripsi |
---|---|---|
color | String | Warna font dalam notasi CSS seperti '#ffffff' atau 'white' ; nilai
null 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
Nama | 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 baris 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 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 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 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)
Tetapkan 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
Nama | Jenis | Deskripsi |
---|---|---|
fontStyle | String | Gaya font, baik '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
Nama | Jenis | Deskripsi |
---|---|---|
fontWeight | String | Ketebalan font, 'bold' atau '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
Nama | 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
Nama | 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)
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, 'left' , 'center' , atau '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
Nama | Jenis | Deskripsi |
---|---|---|
note | String | Teks catatan yang akan ditetapkan; 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 dapat 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
Nama | 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 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 hyperlink akan 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 disimpulkan, 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
Nama | Jenis | Deskripsi |
---|---|---|
direction | TextDirection | Arah teks yang diinginkan; jika null , arah disimpulkan sebelum
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
setTextRotation(degrees)
Menetapkan setelan rotasi teks untuk sel di setiap Range
dalam daftar rentang. Input
sesuai dengan sudut antara orientasi teks standar dan orientasi
yang diinginkan. Input nol menunjukkan bahwa teks disetel ke orientasi standar.
Untuk arah teks kiri ke kanan, sudut positifnya berlawanan arah jarum jam, sedangkan untuk kanan ke kiri, 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 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 bisa berupa numerik, string, boolean, atau tanggal. Jika diawali dengan '=', ini akan 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
Nama | 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
Nama | Jenis | Deskripsi |
---|---|---|
alignment | String | Perataan, 'top' , 'middle' , atau '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 menumpuk teks untuk sel bagi 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
Nama | Jenis | Deskripsi |
---|---|---|
isVertical | Boolean | 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)
Tetapkan penggabungan teks untuk setiap Range
dalam daftar rentang. Sel dengan wrap yang diaktifkan mengubah ukuran
untuk menampilkan konten lengkapnya. Sel dengan penggabungan yang dinonaktifkan akan 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. |
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
Nama | 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 teks setiap sel, serta mengurangi suburutan 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
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