Class Group

Group

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

MetodeJenis hasil yang ditampilkanDeskripsi singkat
collapse()GroupMenciutkan grup ini.
expand()GroupLuaskan grup ini.
getControlIndex()IntegerMenampilkan indeks tombol kontrol dari grup ini.
getDepth()IntegerMenampilkan kedalaman grup ini.
getRange()RangeMenampilkan rentang tempat grup ini berada.
isCollapsed()BooleanMenampilkan true jika grup ini diciutkan.
remove()voidMenghapus 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

Booleantrue 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

Lihat juga