Class Selection

Selezione

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

MetodoTipo restituitoBreve descrizione
getActiveRange()RangeRestituisce l'intervallo selezionato nel foglio attivo o null se non è presente alcun intervallo attivo.
getActiveRangeList()RangeListRestituisce l'elenco di intervalli attivi nel foglio attivo o null se non sono presenti intervalli attivi intervalli di tempo.
getActiveSheet()SheetRestituisce il foglio attivo nel foglio di lavoro.
getCurrentCell()RangeRestituisce la cella corrente (evidenziata) selezionata in uno degli intervalli attivi oppure null se non è presente cella.
getNextDataRange(direction)RangeA 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

NomeTipoDescrizione
directionDirectionLa 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