uzyskiwać dostęp do grup arkuszy kalkulacyjnych i modyfikować ich ustawienia; Grupy to powiązanie między przedziałami przylegających do siebie wiersze lub kolumny, które można rozwinąć lub zwinąć, aby ukryć lub wyświetlić wiersze bądź kolumny. Każda grupa ma przełącznik kontrolny w wierszu lub kolumnie bezpośrednio przed grupą lub za nią. (w zależności od ustawień), które mogą rozwijać lub zwijać całą grupę.
Głębokość grupy odnosi się do zagnieżdżonej pozycji grupy i liczby większych grupy zawierają grupę. Stan zwinięty grupy wskazuje, czy została ona powinna pozostać zwinięta lub rozwinięta po rozwinięciu grupy nadrzędnej. Dodatkowo na stronie Gdy grupa zostanie zwinięta lub rozwinięta, wiersze lub kolumny w tej grupie są ukryte lub są widoczne, chociaż poszczególne wiersze lub kolumny mogą zostać ukryte albo ustawione jako widoczne, niezależnie od tego, stan zwinięty.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
collapse() | Group | Zwija tę grupę. |
expand() | Group | Rozwinięcie tej grupy. |
getControlIndex() | Integer | Zwraca indeks przełącznika tej grupy. |
getDepth() | Integer | Zwraca głębokość danej grupy. |
getRange() | Range | Zwraca zakres, w którym istnieje ta grupa. |
isCollapsed() | Boolean | Zwraca true , jeśli ta grupa jest zwinięta. |
remove() | void | Usuwa tę grupę z arkusza, zmniejszając głębokość grupy range o
jeden. |
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();
Powrót
Group
– ta grupa na potrzeby tworzenia łańcuchów,
Autoryzacja
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()
Rozwinięcie tej grupy.
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();
Powrót
Group
– ta grupa na potrzeby tworzenia łańcuchów,
Autoryzacja
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 tej grupy. To jest indeks tuż przed zakresem, gdy przełącznik jest wyświetlany przed grupą, a 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();
Powrót
Integer
– indeks kontrolny tej grupy
Autoryzacja
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ść danej 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();
Powrót
Integer
– stopień zaawansowania tej grupy
Autoryzacja
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();
Powrót
Range
– zakres, w którym istnieje grupa;
Autoryzacja
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 true
, jeśli ta 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();
Powrót
Boolean
– true
, jeśli ta grupa jest zwinięta; w przeciwnym razie zwraca false
Autoryzacja
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 głębokość grupy range
o
jeden. Może to zmodyfikować inne grupy. Po wywołaniu obiektu grupy nie można go użyć.
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();
Autoryzacja
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