Class Group

Group

Mengakses dan mengubah grup spreadsheet. Grup adalah asosiasi antara interval yang berdekatan baris atau kolom yang dapat diperluas atau diciutkan sebagai unit untuk menyembunyikan/menampilkan baris atau kolom. Setiap grup memiliki tombol kontrol di baris atau kolom tepat sebelum atau setelah grup (bergantung pada setelan) yang dapat meluaskan atau menciutkan grup secara keseluruhan.

Kedalaman grup mengacu pada posisi bertingkat grup dan seberapa banyak grup yang lebih besar grup yang berisi grup tersebut. Status diciutkan suatu grup mengacu pada apakah grup tersebut harus tetap diciutkan atau diluaskan setelah grup induk diperluas. Selain itu, pada saat grup diciutkan atau diluaskan, baris atau kolom dalam grup akan disembunyikan atau ditetapkan terlihat, meskipun setiap baris atau kolom dapat disembunyikan atau terlihat, terlepas dari status diciutkan.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
collapse()GroupCiutkan grup ini.
expand()GroupLuaskan grup ini.
getControlIndex()IntegerMenampilkan indeks tombol kontrol grup ini.
getDepth()IntegerMenampilkan kedalaman grup ini.
getRange()RangeMenampilkan rentang yang mencakup grup ini.
isCollapsed()BooleanMenampilkan true jika grup ini diciutkan.
remove()voidMenghapus grup ini dari sheet, mengurangi kedalaman grup range sebesar satu.

Dokumentasi mendetail

collapse()

Ciutkan 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();

Pulang pergi

Group — grup ini, untuk perantai

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

Pulang pergi

Group — grup ini, untuk perantai

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 grup ini. Ini adalah indeks tepat sebelum rentang ketika tombol alih 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();

Pulang pergi

Integer — indeks tombol kontrol 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();

Pulang pergi

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 yang mencakup grup ini. 

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

Pulang pergi

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

Pulang pergi

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, mengurangi kedalaman grup range sebesar satu. Tindakan ini dapat mengubah grup lainnya. Setelah memanggil objek 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