Class Selection

Selezione

Accedi alla selezione attiva corrente nel foglio attivo. Una selezione è l'insieme di celle che l'utente ha evidenziato nel foglio, che possono essere intervalli non adiacenti. Una delle celle nella selezione è la cella corrente, in cui si trova l'attenzione corrente dell'utente. La cella corrente è evidenziata con un bordo più scuro nell'interfaccia utente di Fogli Google. 

const activeSheet = SpreadsheetApp.getActiveSheet();
const rangeList = activeSheet.getRangeList(['A1:B4', 'D1:E4']);
rangeList.activate();

const 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
const ranges = selection.getActiveRangeList().getRanges();
for (let i = 0; i < ranges.length; i++) {
  console.log(`Active Ranges: ${ranges[i].getA1Notation()}`);
}
console.log(`Active Sheet: ${selection.getActiveSheet().getName()}`);

Metodi

MetodoTipo restituitoBreve descrizione
getActiveRange()RangeRestituisce l'intervallo selezionato nel foglio attivo o null se non è presente alcun intervallo attivo.
getActiveRangeList()RangeListRestituisce l'elenco degli intervalli attivi nel foglio attivo o null se non sono presenti intervalli attivi.
getActiveSheet()SheetRestituisce il foglio attivo nel foglio di lavoro.
getCurrentCell()RangeRestituisce la cella corrente (evidenziata) selezionata in uno degli intervalli attivi o null se non esiste una cella corrente.
getNextDataRange(direction)RangeA partire da current cell e active range e spostandosi nella direzione indicata, restituisce un intervallo modificato in cui il lato appropriato dell'intervallo è stato spostato per coprire next data cell, coprendo al contempo la cella corrente.

Documentazione dettagliata

getActiveRange()

Restituisce l'intervallo selezionato nel foglio attivo o null se non è presente alcun intervallo attivo. Se sono selezionati più intervalli, questo metodo restituisce solo l'ultimo intervallo selezionato. 

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

Invio

Range: l'intervallo attivo.

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

getActiveRangeList()

Restituisce l'elenco degli intervalli attivi nel foglio attivo o null se non sono presenti intervalli attivi.

Se è selezionato un singolo intervallo, il comportamento è simile a una chiamata getActiveRange(). 

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

Invio

RangeList: l'elenco degli intervalli attivi.

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

getActiveSheet()

Restituisce il foglio attivo nel foglio di lavoro. 

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const activeSheet = selection.getActiveSheet();

Invio

Sheet: il foglio attivo nel foglio di lavoro.

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

getCurrentCell()

Restituisce la cella corrente (evidenziata) selezionata in uno degli intervalli attivi o null se non esiste una cella corrente. 

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

Invio

Range: la cella corrente.

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

getNextDataRange(direction)

A partire da current cell e active range e spostandosi nella direzione indicata, restituisce un intervallo modificato in cui il lato appropriato dell'intervallo è stato spostato per coprire next data cell, coprendo al contempo la cella corrente. Se l'intervallo attivo non è limitato lungo dimension della direzione, viene restituito l'intervallo attivo originale. Se non è presente una cella corrente o un intervallo attivo, viene restituito null. Equivale a selezionare un intervallo nell'editor e premere Ctrl+Shift+[arrow key]. 

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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(),
);

Parametri

NomeTipoDescrizione
directionDirectionLa direzione in cui trovare la cella del bordo della regione di dati successiva.

Invio

Range: l'intervallo modificato che include la cella di dati o null se non è stata effettuata alcuna selezione.

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