Mengakses dan mengubah grup {i>spreadsheet<i}. Grup adalah pengaitan antara interval baris atau kolom berdekatan yang dapat diperluas atau diciutkan sebagai unit untuk menyembunyikan/menampilkan baris atau kolom. Setiap grup memiliki tombol kontrol di baris atau kolom langsung sebelum atau setelah grup (bergantung pada setelan) yang dapat meluaskan atau menciutkan grup secara keseluruhan.
Kedalaman grup mengacu pada posisi bertingkat grup dan jumlah grup lebih besar yang berisi grup. Status diciutkan grup mengacu pada apakah grup harus tetap diciutkan atau diluaskan setelah grup induk diperluas. Selain itu, saat grup diciutkan atau diluaskan, baris atau kolom dalam grup akan disembunyikan atau ditetapkan terlihat, meskipun setiap baris atau kolom dapat disembunyikan atau disetel terlihat terlepas dari status diciutkan.
Metode
Metode | Jenis hasil yang ditampilkan | Deskripsi singkat |
---|---|---|
collapse() | Group | Menciutkan grup ini. |
expand() | Group | Luaskan grup ini. |
getControlIndex() | Integer | Menampilkan indeks tombol kontrol dari grup ini. |
getDepth() | Integer | Menampilkan kedalaman grup ini. |
getRange() | Range | Menampilkan rentang tempat grup ini berada. |
isCollapsed() | Boolean | Menampilkan true jika grup ini diciutkan. |
remove() | void | Menghapus grup ini dari sheet, sehingga mengurangi kedalaman grup range satu per satu. |
Dokumentasi mendetail
collapse()
Menciutkan grup ini.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Collapses this group. group.collapse();
Return
Group
— grup 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
expand()
Luaskan grup ini.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Expands this group. group.expand();
Return
Group
— grup 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
getControlIndex()
Menampilkan indeks tombol kontrol dari grup ini. Ini adalah indeks tepat sebelum rentang saat tombol kontrol ditampilkan sebelum grup, atau indeks tepat setelah rentang.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlAfter(true); var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Returns 4 var controlIndex = group.getControlIndex();
Return
Integer
— indeks tombol kontrol dari grup ini
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
getDepth()
Menampilkan kedalaman grup ini.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Returns 1 if the group is at depth 1. var depth = group.getDepth();
Return
Integer
— kedalaman grup ini
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
getRange()
Menampilkan rentang tempat grup ini berada.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(1, 1); // Returns the range 2:3 if the group is over rows 2:3 range = group.getRange();
Return
Range
— rentang tempat grup berada
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
isCollapsed()
Menampilkan true
jika grup ini diciutkan.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Returns true if the group is collapsed. var isCollapsed = group.isCollapsed();
Return
Boolean
— true
jika grup ini diciutkan; akan menampilkan false
jika tidak
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
remove()
Menghapus grup ini dari sheet, sehingga mengurangi kedalaman grup range
satu per satu. Tindakan ini dapat mengubah grup lain. Setelah memanggil ini, objek grup menjadi tidak valid untuk digunakan.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Removes this group var range = group.remove();
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