Class Selection

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.
Selección

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, en la que el enfoque actual del usuario es destacado. 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
Logger.log('Current Cell: ' + selection.getCurrentCell().getA1Notation());
// Active Range: D1:E4
Logger.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++) {
  Logger.log('Active Ranges: ' + ranges[i].getA1Notation());
}
Logger.log('Active Sheet: ' + selection.getActiveSheet().getName());

Métodos

MétodoTipo de datos que se muestraDescripción breve
getActiveRange()RangeMuestra el rango seleccionado en la hoja activa o null si no hay un rango activo.
getActiveRangeList()RangeListMuestra la lista de rangos activos en la hoja activa o null si no hay rangos activos.
getActiveSheet()SheetMuestra la hoja activa en la hoja de cálculo.
getCurrentCell()RangeMuestra la celda actual (destacada) que está seleccionada en uno de los rangos activos o null si no hay una celda actual.
getNextDataRange(direction)RangeA partir de current cell y active range, y moviéndote en la dirección determinada, muestra un rango ajustado en el que se cambió el borde apropiado del rango para cubrir la next data cell y, al mismo tiempo, se abarca 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 muestra solo el último rango seleccionado.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
var activeRange = selection.getActiveRange();

Volver

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, esto se comporta como una llamada getActiveRange().

var sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
var activeRangeList = sheet.getActiveRangeList();

Volver

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

Volver

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 (destacada) que está seleccionada en uno de los rangos activos o null si no hay una celda actual.

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
// Returns the current highlighted cell in the one of the active ranges.
var currentCell = selection.getCurrentCell();

Volver

Range: 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 moviéndote en la dirección determinada, muestra un rango ajustado en el que se cambió el borde apropiado del rango para cubrir la next data cell y, al mismo tiempo, se abarca 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, 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"
Logger.log(SpreadsheetApp.getSelection().getNextDataRange(Direction.UP).getA1Notation());

Parámetros

NombreTipoDescripción
directionDirectionLa dirección en la que se encuentra la próxima celda perimetral de la región de datos.

Volver

Range: Es el rango ajustado que incluye la celda de datos o null si no hay ninguna 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