Class Group

Gruppe

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

MethodeRückgabetypKurzbeschreibung
collapse()GroupMinimiert diese Gruppe.
expand()GroupMaximiert diese Gruppe.
getControlIndex()IntegerGibt den Index zum Ein-/Ausschalten dieser Gruppe zurück
getDepth()IntegerGibt die Tiefe dieser Gruppe zurück
getRange()RangeGibt den Bereich zurück, in dem diese Gruppe vorhanden ist.
isCollapsed()BooleanGibt true zurück, wenn diese Gruppe minimiert ist.
remove()voidEntfernt 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

Weitere Informationen