Acceder a grupos de hojas de cálculo y modificarlos Los grupos son una asociación entre un intervalo de valores contiguos filas o columnas que se pueden expandir o contraer como una unidad para ocultar o mostrar las filas o columnas. Cada grupo tiene un control de activación en la fila o columna directamente antes o después del grupo. (según la configuración) que pueden expandir o contraer todo el grupo.
La profundidad de un grupo se refiere a la posición anidada del grupo y cuántos tamaños más grandes, grupos contienen el grupo. El estado contraído de un grupo indica si el grupo debe permanecer contraído o expandido después de que se haya expandido un grupo superior. Además, en la tiempo que se contrae o expande un grupo, las filas o columnas dentro del grupo quedan ocultas o sea visible, pero las filas o columnas individuales se pueden ocultar o establecer como visibles, independientemente de la contraído.
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
collapse() | Group | Contrae este grupo. |
expand() | Group | Expande este grupo. |
getControlIndex() | Integer | Muestra el índice del botón de activación del control de este grupo. |
getDepth() | Integer | Muestra la profundidad de este grupo. |
getRange() | Range | Muestra el rango en el que existe este grupo. |
isCollapsed() | Boolean | Muestra true si este grupo está contraído. |
remove() | void | Quita este grupo de la hoja, lo que reduce la profundidad del grupo de range en
uno. |
Documentación detallada
collapse()
Contrae este grupo.
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();
Volver
Group
: Este grupo, para el encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand()
Expande este grupo.
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();
Volver
Group
: Este grupo, para el encadenamiento
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getControlIndex()
Muestra el índice del botón de activación del control de este grupo. Este es el índice que está justo antes del rango cuando El botón de activación del control se muestra antes del grupo o, de lo contrario, el índice se muestra después del rango.
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();
Volver
Integer
: el índice del botón de activación de control de este grupo
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDepth()
Muestra la profundidad de este grupo.
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();
Volver
Integer
: la profundidad de este grupo
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange()
Muestra el rango en el que existe este grupo.
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();
Volver
Range
: Es el rango en el que existe el grupo.
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isCollapsed()
Muestra true
si este grupo está contraído.
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();
Volver
Boolean
: true
si este grupo está contraído; De lo contrario, devuelve false
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
Quita este grupo de la hoja, lo que reduce la profundidad del grupo de range
en
uno. Esto podría modificar otros grupos. Después de llamar a este objeto, el objeto de grupo deja de ser válido.
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();
Autorización
Las secuencias de comandos que usan este método requieren autorización con uno o más de los siguientes alcances:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets