Class Selection

Selezione

Consente di accedere alla selezione attiva corrente nel foglio attivo. Una selezione è l'insieme di celle evidenziate dall'utente nel foglio, che possono essere intervalli non adiacenti. Una cella della selezione è la cella corrente, dove si trova l'elemento attivo dell'utente. La cella corrente è evidenziata con un bordo più scuro nell'interfaccia utente di Fogli 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());

Metodi

Metodo	Tipo restituito	Breve descrizione
getActiveRange()	Range	Restituisce l'intervallo selezionato nel foglio attivo oppure null se non è presente alcun intervallo attivo.
getActiveRangeList()	RangeList	Restituisce l'elenco di intervalli attivi nel foglio attivo o null se non sono presenti intervalli attivi.
getActiveSheet()	Sheet	Restituisce il foglio attivo nel foglio di lavoro.
getCurrentCell()	Range	Restituisce la cella corrente (evidenziata) selezionata in uno degli intervalli attivi o null se non è presente alcuna cella corrente.
getNextDataRange(direction)	Range	Partendo da current cell e active range e spostandosi nella direzione specificata, restituisce un intervallo modificato in cui il bordo appropriato dell'intervallo è stato spostato per coprire next data cell pur continuando a coprire la cella corrente.

Documentazione dettagliata

getActiveRange()

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

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

Ritorni

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 di intervalli attivi nel foglio attivo o null se non sono presenti intervalli attivi.

Se è stato selezionato un singolo intervallo, si comporta come una chiamata getActiveRange().

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

Ritorni

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.

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

Ritorni

Sheet: 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.

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

Ritorni

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)

Partendo da current cell e active range e spostandosi nella direzione specificata, restituisce un intervallo modificato in cui il bordo appropriato dell'intervallo è stato spostato per coprire next data cell pur continuando a coprire la cella corrente. Se l'intervallo attivo non è limitato lungo il dimension della direzione, viene restituito l'intervallo attivo originale. Se non è presente alcuna cella o intervallo attivo corrente, viene restituito null. Equivale a selezionare un intervallo nell'editor e a premere 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());

Parametri

Nome	Tipo	Descrizione
direction	Direction	La direzione in cui trovare la cella perimetrale della regione di dati successiva.

Ritorni

Range: l'intervallo modificato che include la cella di dati o null se non viene selezionata 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