Class RangeList

RangeList

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
activate()RangeListMemilih daftar instance Range.
breakApart()RangeListPisahkan semua sel yang digabungkan secara horizontal atau vertikal yang ada dalam daftar rentang menjadi kembali setiap sel.
check()RangeListMengubah status kotak centang dalam rentang menjadi "dicentang".
clear()RangeListMenghapus rentang konten, format, dan aturan validasi data untuk setiap Range dalam daftar rentang.
clear(options)RangeListMenghapus rentang konten, format, aturan validasi data, dan komentar, seperti yang ditentukan dengan opsi yang diberikan.
clearContent()RangeListMenghapus konten setiap Range dalam daftar rentang, tanpa mengubah formatnya.
clearDataValidations()RangeListMenghapus aturan validasi data untuk setiap Range dalam daftar rentang.
clearFormat()RangeListMenghapus pemformatan teks untuk setiap Range dalam daftar rentang.
clearNote()RangeListMenghapus catatan untuk setiap Range dalam daftar rentang.
getRanges()Range[]Menampilkan daftar satu atau beberapa instance Range dalam sheet yang sama.
insertCheckboxes()RangeListMenyisipkan kotak centang ke setiap sel dalam rentang, yang dikonfigurasi dengan true untuk dicentang dan false untuk yang tidak dicentang.
insertCheckboxes(checkedValue)RangeListMenyisipkan 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)RangeListMenyisipkan kotak centang ke dalam setiap sel dalam rentang, yang dikonfigurasi dengan nilai kustom untuk status yang dicentang dan tidak dicentang.
removeCheckboxes()RangeListMenghapus semua kotak centang dari rentang.
setBackground(color)RangeListMenetapkan warna latar belakang untuk setiap Range dalam daftar rentang.
setBackgroundRGB(red, green, blue)RangeListMenetapkan latar belakang ke warna RGB yang ditentukan.
setBorder(top, left, bottom, right, vertical, horizontal)RangeListMenetapkan properti batas untuk setiap Range dalam daftar rentang.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeListMenetapkan properti batas dengan warna dan/atau gaya untuk setiap Range dalam daftar rentang.
setFontColor(color)RangeListMenetapkan warna font untuk setiap Range dalam daftar rentang.
setFontFamily(fontFamily)RangeListMenetapkan jenis font untuk setiap Range dalam daftar rentang.
setFontLine(fontLine)RangeListMenetapkan gaya baris font untuk setiap Range dalam daftar rentang.
setFontSize(size)RangeListMenetapkan ukuran font (dalam poin) untuk setiap Range dalam daftar rentang.
setFontStyle(fontStyle)RangeListTetapkan gaya font untuk setiap Range dalam daftar rentang.
setFontWeight(fontWeight)RangeListTetapkan ketebalan font untuk setiap Range dalam daftar rentang.
setFormula(formula)RangeListMemperbarui formula untuk setiap Range dalam daftar rentang.
setFormulaR1C1(formula)RangeListMemperbarui formula untuk setiap Range dalam daftar rentang.
setHorizontalAlignment(alignment)RangeListTetapkan perataan horizontal untuk setiap Range dalam daftar rentang.
setNote(note)RangeListMenetapkan teks catatan untuk setiap Range dalam daftar rentang.
setNumberFormat(numberFormat)RangeListMenetapkan format angka atau tanggal untuk setiap Range dalam daftar rentang.
setShowHyperlink(showHyperlink)RangeListMenetapkan apakah setiap Range dalam daftar rentang harus menampilkan hyperlink atau tidak.
setTextDirection(direction)RangeListMenetapkan arah teks untuk sel di setiap Range dalam daftar rentang.
setTextRotation(degrees)RangeListMenetapkan setelan rotasi teks untuk sel di setiap Range dalam daftar rentang.
setValue(value)RangeListMenetapkan nilai untuk setiap Range dalam daftar rentang.
setVerticalAlignment(alignment)RangeListTetapkan perataan vertikal untuk setiap Range dalam daftar rentang.
setVerticalText(isVertical)RangeListMenetapkan apakah akan menumpuk teks untuk sel bagi setiap Range dalam daftar rentang atau tidak.
setWrap(isWrapEnabled)RangeListTetapkan penggabungan teks untuk setiap Range dalam daftar rentang.
setWrapStrategy(strategy)RangeListMenetapkan strategi penggabungan teks untuk setiap Range dalam daftar rentang.
trimWhitespace()RangeListMemangkas spasi kosong (seperti spasi, tab, atau baris baru) di setiap sel dalam daftar rentang ini.
uncheck()RangeListMengubah 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

NamaJenisDeskripsi
optionsObjectObjek JavaScript yang menentukan parameter lanjutan, seperti yang tercantum di bawah ini.

Parameter lanjutan

NamaJenisDeskripsi
commentsOnlyBooleanApakah hanya menghapus komentar.
contentsOnlyBooleanApakah hanya akan menghapus konten.
formatOnlyBooleanApakah akan menghapus format saja; perhatikan bahwa menghapus format juga akan menghapus aturan validasi data.
validationsOnlyBooleanApakah hanya akan menghapus aturan validasi data.
skipFilteredRowsBooleanApakah 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

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

NamaJenisDeskripsi
checkedValueObjectNilai yang dicentang untuk validasi data kotak centang.
uncheckedValueObjectNilai 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

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

NamaJenisDeskripsi
redIntegerNilai merah dalam notasi RGB.
greenIntegerNilai hijau dalam notasi RGB.
blueIntegerNilai 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

NamaJenisDeskripsi
topBooleantrue untuk batas, false untuk tidak ada, null jika tidak ada perubahan.
leftBooleantrue untuk batas, false untuk tidak ada, null jika tidak ada perubahan.
bottomBooleantrue untuk batas, false untuk tidak ada, null jika tidak ada perubahan.
rightBooleantrue untuk batas, false untuk tidak ada, null jika tidak ada perubahan.
verticalBooleantrue untuk batas vertikal internal, false untuk tidak ada, null jika tidak ada perubahan.
horizontalBooleantrue 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

NamaJenisDeskripsi
topBooleantrue untuk batas, false untuk tidak ada, null jika tidak ada perubahan.
leftBooleantrue untuk batas, false untuk tidak ada, null jika tidak ada perubahan.
bottomBooleantrue untuk batas, false untuk tidak ada, null jika tidak ada perubahan.
rightBooleantrue untuk batas, false untuk tidak ada, null jika tidak ada perubahan.
verticalBooleantrue untuk batas vertikal internal, false untuk tidak ada, null jika tidak ada perubahan.
horizontalBooleantrue untuk batas horizontal internal, false untuk tidak ada, null jika tidak ada perubahan.
colorStringWarna batas dalam notasi CSS seperti '#ffffff' atau 'white', null untuk warna default (hitam).
styleBorderStyleGaya 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

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

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

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

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

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

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

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

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

NamaJenisDeskripsi
alignmentStringPerataan, '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

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

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

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

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

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

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

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

NamaJenisDeskripsi
alignmentStringPerataan, '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

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

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

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