Class Group

Group

Mengakses dan mengubah grup spreadsheet. Grup adalah pengaitan antara interval baris atau kolom berurutan yang dapat diluaskan atau diciutkan sebagai unit untuk menyembunyikan/menampilkan baris atau kolom. Setiap grup memiliki tombol kontrol pada 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 jumlah grup yang lebih besar yang berisi grup tersebut. Status diciutkan dari grup mengacu pada apakah grup harus tetap diciutkan atau diluaskan setelah grup induk diluaskan. 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 ditetapkan terlihat, terlepas dari status diciutkan.

Metode

MetodeJenis hasil yang ditampilkanDeskripsi singkat
collapse()GroupMenciutkan grup ini.
expand()GroupLuaskan grup ini.
getControlIndex()IntegerMenampilkan indeks tombol kontrol 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 sebesar satu.

Dokumentasi mendetail

collapse()

Menciutkan grup ini. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);

// Collapses this group.
group.collapse();

Pulang pergi

Group — grup ini, untuk penyambungan

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. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);

// Expands this group.
group.expand();

Pulang pergi

Group — grup ini, untuk penyambungan

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 saat tombol kontrol ditampilkan sebelum grup, atau indeks tepat setelah rentang. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setRowGroupControlAfter(true);
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);

// Returns 4
const 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. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);

// Returns 1 if the group is at depth 1.
const 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 tempat grup ini berada. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
let range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const 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. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);

// Returns true if the group is collapsed.
const isCollapsed = group.isCollapsed();

Pulang pergi

Boolean — true jika grup ini diciutkan; 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 sebesar satu. Tindakan ini dapat mengubah grup lain. Setelah memanggil ini, objek grup menjadi tidak valid untuk digunakan. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
let range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);

// Removes this group
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