Class Group

Gruppo

Accedere ai gruppi di fogli di lavoro e modificarli. I gruppi sono un'associazione tra un intervallo di righe o colonne che possono essere espanse o compresse come unità per nascondere/mostrare le righe o le colonne. Per ogni gruppo è presente un pulsante di attivazione/disattivazione del controllo sulla riga o sulla colonna subito prima o dopo il gruppo (a seconda delle impostazioni) che può espandere o comprimere l'intero gruppo.

La profondità di un gruppo si riferisce alla posizione nidificata del gruppo e a quanti sono i più grandi gruppi contengono il gruppo. Lo stato compresso di un gruppo si riferisce al fatto che il gruppo deve rimanere compresso o espanso dopo l'espansione del gruppo principale. Inoltre, nel volta che un gruppo viene compresso o espanso, le righe o le colonne al suo interno vengono nascoste o impostare come visibile, anche se le singole righe o colonne possono essere nascoste o impostate come visibili indipendentemente in uno stato compresso.

Metodi

MetodoTipo restituitoBreve descrizione
collapse()GroupComprime questo gruppo.
expand()GroupEspande questo gruppo.
getControlIndex()IntegerRestituisce l'indice di attivazione/disattivazione del controllo di questo gruppo.
getDepth()IntegerRestituisce la profondità di questo gruppo.
getRange()RangeRestituisce l'intervallo nel quale esiste il gruppo.
isCollapsed()BooleanRestituisce true se questo gruppo è compresso.
remove()voidRimuove questo gruppo dal foglio, riducendo la profondità del gruppo di range di uno.

Documentazione dettagliata

collapse()

Comprime questo gruppo. 

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

Invio

Group: questo gruppo, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

expand()

Espande questo gruppo. 

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

Invio

Group: questo gruppo, per il concatenamento

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getControlIndex()

Restituisce l'indice di attivazione/disattivazione del controllo di questo gruppo. Si tratta dell'indice appena prima dell'intervallo quando l'opzione di attivazione/disattivazione del controllo viene mostrata prima del gruppo, altrimenti l'indice subito dopo l'intervallo. 

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

Invio

Integer: l'indice di attivazione/disattivazione del controllo di questo gruppo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getDepth()

Restituisce la profondità di questo gruppo. 

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

Invio

Integer: la profondità di questo gruppo

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

getRange()

Restituisce l'intervallo nel quale esiste il gruppo. 

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

Invio

Range: l'intervallo nel quale esiste il gruppo.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

isCollapsed()

Restituisce true se questo gruppo è compresso. 

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

Invio

Boolean - true se questo gruppo è compresso; restituisce false altrimenti

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

remove()

Rimuove questo gruppo dal foglio, riducendo la profondità del gruppo di range di uno. Questa operazione può modificare altri gruppi. Dopo la chiamata, l'oggetto di gruppo non può più essere utilizzato. 

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

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

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

Vedi anche