Accede a la selección activa actual en la hoja activa. Una selección es el conjunto de celdas que el usuario destacó en la hoja, que pueden ser rangos no adyacentes. Una celda de la selección es la celda actual, donde está el enfoque actual del usuario. La celda actual se destaca con un borde más oscuro en la IU de Hojas de cálculo de Google.
var activeSheet = SpreadsheetApp.getActiveSheet(); var rangeList = activeSheet.getRangeList(['A1:B4', 'D1:E4']); rangeList.activate(); var selection = activeSheet.getSelection(); // Current Cell: D1 console.log('Current Cell: ' + selection.getCurrentCell().getA1Notation()); // Active Range: D1:E4 console.log('Active Range: ' + selection.getActiveRange().getA1Notation()); // Active Ranges: A1:B4, D1:E4 var ranges = selection.getActiveRangeList().getRanges(); for (var i = 0; i < ranges.length; i++) { console.log('Active Ranges: ' + ranges[i].getA1Notation()); } console.log('Active Sheet: ' + selection.getActiveSheet().getName());
Métodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
getActiveRange() | Range | Muestra el rango seleccionado en la hoja activa o null si no hay un rango activo. |
getActiveRangeList() | RangeList | Muestra la lista de rangos activos en la hoja activa o null si no hay rangos activos. |
getActiveSheet() | Sheet | Muestra la hoja activa en la hoja de cálculo. |
getCurrentCell() | Range | Muestra la celda actual (resaltada) que está seleccionada en uno de los rangos activos o null si no hay ninguna celda actual. |
getNextDataRange(direction) | Range | A partir de current cell y active range , y el movimiento se realiza en la dirección determinada, se muestra un rango ajustado en el que el borde apropiado del rango se cambió para cubrir el next data cell y, al mismo tiempo, cubrir la celda actual. |
Documentación detallada
getActiveRange()
Muestra el rango seleccionado en la hoja activa o null
si no hay un rango activo. Si se seleccionan varios rangos, este método solo muestra el último rango seleccionado.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var activeRange = selection.getActiveRange();
Devolvedor
Range
: Es el rango activo.
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
getActiveRangeList()
Muestra la lista de rangos activos en la hoja activa o null
si no hay rangos activos.
Si hay un solo rango seleccionado, se comportará como una llamada getActiveRange()
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var activeRangeList = sheet.getActiveRangeList();
Devolvedor
RangeList
: Es la lista de rangos activos.
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
getActiveSheet()
Muestra la hoja activa en la hoja de cálculo.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var activeSheet = selection.getActiveSheet();
Devolvedor
Sheet
: Es la hoja activa en la hoja de cálculo.
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
getCurrentCell()
Muestra la celda actual (resaltada) que está seleccionada en uno de los rangos activos o null
si no hay ninguna celda actual.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = selection.getCurrentCell();
Devolvedor
Range
: Es la celda actual.
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
getNextDataRange(direction)
A partir de current cell
y active range
, y el movimiento se realiza en la dirección determinada, se muestra un rango ajustado en el que el borde apropiado del rango se cambió para cubrir el next data cell
y, al mismo tiempo, cubrir la celda actual. Si el rango activo no está delimitado a lo largo del dimension
de la dirección, se muestra el rango activo original. Si no hay una celda o un rango activo actual, se muestra null
. Esto equivale a seleccionar un rango en el editor y presionar Ctrl+Shift+[arrow key]
.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // Makes C3 the current cell and C3:E5 the active range. sheet.getRange('C3:E5').activate(); // Logs 'C1:E3' console.log(SpreadsheetApp.getSelection() .getNextDataRange(SpreadsheetApp.Direction.UP) .getA1Notation());
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
direction | Direction | La dirección en la que se encuentra la siguiente celda perimetral de la región de datos. |
Devolvedor
Range
: Es el rango ajustado que incluye la celda de datos, o null
si no hay una selección.
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