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