Class Group

Grupa

uzyskiwać dostęp do grup arkuszy kalkulacyjnych i modyfikować je; Grupy stanowią powiązanie między sąsiednimi wierszami lub kolumnami, które można rozwijać i zwijać jako jednostkę w celu ukrycia lub wyświetlenia wierszy bądź kolumn. Każda grupa ma przełącznik sterowania w wierszu lub kolumnie bezpośrednio przed lub za grupą (w zależności od ustawień), który umożliwia rozwijanie lub zwijanie całej grupy.

Parametr depth (głębokość) grupy odnosi się do umieszczonej w niej pozycji grupy i określenia, ile większych grup zawiera tę grupę. Stan zwinięty grupy określa, czy po rozwinięciu grupy nadrzędnej powinna pozostać zwinięta czy rozwinięta. Poza tym w momencie, gdy grupa jest zwinięta lub rozwinięta, zawarte w niej wiersze lub kolumny są ukryte lub ustawione, chociaż pojedyncze wiersze lub kolumny mogą być ukryte lub widoczne niezależnie od tego, czy są zwinięte.

Metody

MetodaZwracany typKrótki opis
collapse()GroupZwija tę grupę.
expand()GroupRozwija tę grupę.
getControlIndex()IntegerZwraca indeks przełącznika kontroli tej grupy.
getDepth()IntegerZwraca głębokość tej grupy.
getRange()RangeZwraca zakres, w którym istnieje ta grupa.
isCollapsed()BooleanZwraca wartość true, jeśli grupa jest zwinięta.
remove()voidUsuwa tę grupę z arkusza, zmniejszając o jeden głębokość grupy elementów range.

Szczegółowa dokumentacja

collapse()

Zwija tę grupę. 

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

Powroty

Group – ta grupa do łańcuchów

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

expand()

Rozwija tę grupę. 

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

Powroty

Group – ta grupa do łańcuchów

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getControlIndex()

Zwraca indeks przełącznika kontroli tej grupy. Jest to indeks tuż przed zakresem, gdy przełącznik sterowania jest wyświetlany przed grupą, lub indeks tuż po zakresie. 

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

Powroty

Integer – indeks przełącznika kontroli tej grupy

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDepth()

Zwraca głębokość tej grupy. 

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

Powroty

Integer – głębokość grupy

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange()

Zwraca zakres, w którym istnieje ta grupa. 

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

Powroty

Range – zakres, w którym znajduje się grupa.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

isCollapsed()

Zwraca wartość true, jeśli grupa jest zwinięta. 

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

Powroty

Boolean – true, jeśli grupa jest zwinięta; w przeciwnym razie zwraca false.

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

Usuwa tę grupę z arkusza, zmniejszając o jeden głębokość grupy elementów range. Może to spowodować zmianę innych grup. Po wywołaniu obiektu grupy nie będzie można go używać. 

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

Upoważnienie

Skrypty korzystające z tej metody wymagają autoryzacji z co najmniej jednym z tych zakresów:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Zobacz też