Tabellengruppen aufrufen und bearbeiten Gruppen sind Verknüpfungen zwischen einem Intervall von aufeinanderfolgenden Zeilen oder Spalten, die als Einheit maximiert oder minimiert werden können, um die Zeilen oder Spalten ein- oder auszublenden. Jede Gruppe hat je nach Einstellungen direkt vor oder nach der Gruppe eine Ein-/Aus-Schaltfläche, mit der sich die gesamte Gruppe maximieren oder minimieren lässt.
Die Tiefe einer Gruppe bezieht sich auf die verschachtelte Position der Gruppe und darauf, wie viele größere Gruppen die Gruppe enthalten. Der minimierte Status einer Gruppe gibt an, ob die Gruppe minimiert oder maximiert bleiben soll, nachdem eine übergeordnete Gruppe maximiert wurde. Außerdem werden beim Minimieren oder Maximieren einer Gruppe die Zeilen oder Spalten innerhalb der Gruppe ausgeblendet oder als sichtbar festgelegt. Einzelne Zeilen oder Spalten können jedoch unabhängig vom minimierten Zustand ausgeblendet oder sichtbar sein.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
collapse() | Group | Minimiert diese Gruppe. |
expand() | Group | Maximiert diese Gruppe. |
getControlIndex() | Integer | Gibt den Index zum Ein-/Ausschalten dieser Gruppe zurück |
getDepth() | Integer | Gibt die Tiefe dieser Gruppe zurück |
getRange() | Range | Gibt den Bereich zurück, in dem diese Gruppe vorhanden ist. |
isCollapsed() | Boolean | Gibt true zurück, wenn diese Gruppe minimiert ist. |
remove() | void | Entfernt diese Gruppe aus dem Tabellenblatt und verringert die Gruppentiefe von range um eins. |
Detaillierte Dokumentation
collapse()
Minimiert diese Gruppe.
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
– diese Gruppe für Verkettungen
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand()
Maximiert diese Gruppe.
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
– diese Gruppe für Verkettungen
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getControlIndex()
Gibt den Index zum Ein-/Ausschalten dieser Gruppe zurück Dies ist der Index direkt vor dem Bereich, wenn die Ein-/Aus-Schaltfläche für die Steuerelemente vor der Gruppe angezeigt wird. Andernfalls ist dies der Index direkt nach dem Bereich.
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
– Index der Ein-/Aus-Schaltfläche für Steuerelemente dieser Gruppe
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDepth()
Gibt die Tiefe dieser Gruppe zurück
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
– die Tiefe dieser Gruppe
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange()
Gibt den Bereich zurück, in dem diese Gruppe vorhanden ist.
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
: Bereich, in dem die Gruppe vorhanden ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isCollapsed()
Gibt true
zurück, wenn diese Gruppe minimiert ist.
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
Boolean
: true
, wenn diese Gruppe minimiert ist. Andernfalls wird false
zurückgegeben.
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Entfernt diese Gruppe aus dem Tabellenblatt und verringert die Gruppentiefe von range
um eins. Dies kann Änderungen an anderen Gruppen vornehmen. Danach kann das Gruppenobjekt nicht mehr verwendet werden.
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();
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets