Accedi alla selezione attiva attuale nel foglio attivo. Una selezione è l'insieme di celle in cui l'utente evidenziato nel foglio, che possono essere intervalli non adiacenti. Una cella della selezione è cella attuale, dove si trova l'elemento attivo corrente 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 o 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
intervalli di tempo. |
getActiveSheet() | Sheet | Restituisce il foglio attivo nel foglio di lavoro. |
getCurrentCell() | Range | Restituisce la cella corrente (evidenziata) selezionata in uno degli intervalli attivi oppure null se non è presente cella. |
getNextDataRange(direction) | Range | A partire da current cell e active range
e spostandosi nella direzione data, restituisce un intervallo regolato in cui il bordo appropriato
l'intervallo è stato spostato per coprire next data cell mentre
che copre la cella corrente. |
Documentazione dettagliata
getActiveRange()
Restituisce l'intervallo selezionato nel foglio attivo o null
se non è presente alcun intervallo attivo. Se
se sono selezionati più intervalli questo metodo restituisce solo l'ultimo intervallo selezionato.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var 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 di intervalli attivi nel foglio attivo o null
se non sono presenti intervalli attivi
intervalli di tempo.
Se è selezionato un solo intervallo, si comporta come una chiamata getActiveRange()
.
var sheet = SpreadsheetApp.getActiveSheet(); // Returns the list of active ranges. var 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.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); var 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 oppure null
se non è presente cella.
var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection(); // Returns the current highlighted cell in the one of the active ranges. var currentCell = selection.getCurrentCell();
Invio
Range
: 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 data, restituisce un intervallo regolato in cui il bordo appropriato
l'intervallo è stato spostato per coprire next data cell
mentre
che copre la cella corrente. Se l'intervallo attivo è illimitato lungo la direzione dimension
, viene restituito l'intervallo attivo originale. Se al momento non è presente alcuna cella
o intervallo attivo, viene restituito null
. Equivale a selezionare un intervallo nel
Editor e premendo 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 successiva cella perimetrale della regione di dati. |
Invio
Range
: l'intervallo modificato che include la cella di dati o null
se non sono presenti
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