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 cella della selezione è la cella corrente, su cui si concentra l'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()Range|nullRestituisce l'intervallo selezionato nel foglio attivo o null se non è presente alcun intervallo attivo.
getActiveRangeList()RangeList|nullRestituisce 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()Range|nullRestituisce la cella corrente (evidenziata) selezionata in uno degli intervalli attivi o null se non è presente alcuna cella corrente.
getNextDataRange(direction)Range|nullA partire da current cell e active range e spostandosi nella direzione indicata, restituisce un intervallo aggiustato in cui il bordo appropriato dell'intervallo è stato spostato per coprire next data cell, continuando a coprire la cella corrente.

Documentazione dettagliata

getActiveRange()

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

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

Indietro

Range|null: 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 è quello di una chiamata getActiveRange(). 

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

Indietro

RangeList|null: 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();

Indietro

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 è presente alcuna cella corrente. 

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

Indietro

Range|null: 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 aggiustato in cui il bordo appropriato dell'intervallo è stato spostato per coprire next data cell, continuando a coprire la cella corrente. Se l'intervallo attivo non è delimitato lungo la 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 dell'area dati successiva.

Indietro

Range|null: l'intervallo aggiustato che include la cella di dati o null se non è presente 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