Questa pagina è stata tradotta dall'API Cloud Translation.

Class Range

Accedi agli intervalli del foglio di lavoro e modificali. Un intervallo può essere una singola cella di un foglio o un gruppo di celle adiacenti in un foglio.

Metodi

Metodo	Tipo restituito	Breve descrizione
`activate()`	`Range`	Imposta l'intervallo specificato come `active range`, con la cella in alto a sinistra nell'intervallo come `current cell`.
`activateAsCurrentCell()`	`Range`	Imposta la cella specificata come `current cell`.
`addDeveloperMetadata(key)`	`Range`	Aggiunge all'intervallo i metadati dello sviluppatore con la chiave specificata.
`addDeveloperMetadata(key, visibility)`	`Range`	Aggiunge metadati sviluppatore con la chiave e la visibilità specificate all'intervallo.
`addDeveloperMetadata(key, value)`	`Range`	Aggiunge all'intervallo i metadati dello sviluppatore con la chiave e il valore specificati.
`addDeveloperMetadata(key, value, visibility)`	`Range`	Aggiunge all'intervallo i metadati dello sviluppatore con la chiave, il valore e la visibilità specificati.
`applyColumnBanding()`	`Banding`	Applica all'intervallo un tema predefinito per le bande di colonna.
`applyColumnBanding(bandingTheme)`	`Banding`	Applica all'intervallo un tema specificato per le bande di colonna.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Applica un tema specificato per le bande di colonna all'intervallo con le impostazioni di intestazione e piè di pagina specificate.
`applyRowBanding()`	`Banding`	Applica all'intervallo un tema predefinito per le bande di riga.
`applyRowBanding(bandingTheme)`	`Banding`	Applica all'intervallo un tema specificato per le bande di riga.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Applica all'intervallo con impostazioni di intestazione e piè di pagina un tema specificato per le bande di riga.
`autoFill(destination, series)`	`void`	Compila il campo `destinationRange` con i dati in base ai dati compresi in questo intervallo.
`autoFillToNeighbor(series)`	`void`	Calcola un intervallo per riempire con nuovi dati sulla base di celle vicine e lo riempie automaticamente con nuovi valori in base ai dati contenuti in questo intervallo.
`breakApart()`	`Range`	Suddividi nuovamente le celle a più colonne dell'intervallo in singole celle.
`canEdit()`	`Boolean`	Determina se l'utente è autorizzato a modificare ogni cella dell'intervallo.
`check()`	`Range`	Modifica lo stato delle caselle di controllo nell'intervallo in "Selezionate".
`clear()`	`Range`	Cancella l'intervallo di contenuti e formati.
`clear(options)`	`Range`	Cancella l'intervallo di contenuti, il formato, le regole di convalida dei dati e/o i commenti, come specificato con le opzioni avanzate specificate.
`clearContent()`	`Range`	Cancella i contenuti dell'intervallo, senza modificare la formattazione.
`clearDataValidations()`	`Range`	Cancella le regole di convalida dei dati per l'intervallo.
`clearFormat()`	`Range`	Cancella la formattazione per questo intervallo.
`clearNote()`	`Range`	Cancella la nota nella cella o nelle celle specificate.
`collapseGroups()`	`Range`	Comprime tutti i gruppi che sono interamente contenuti all'interno dell'intervallo.
`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Copia la formattazione dell'intervallo nella posizione specificata.
`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Copia la formattazione dell'intervallo nella posizione specificata.
`copyTo(destination)`	`void`	Copia i dati da un intervallo di celle a un altro intervallo di celle.
`copyTo(destination, copyPasteType, transposed)`	`void`	Copia i dati da un intervallo di celle a un altro intervallo di celle.
`copyTo(destination, options)`	`void`	Copia i dati da un intervallo di celle a un altro intervallo di celle.
`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Copia il contenuto dell'intervallo nella posizione specificata.
`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Copia il contenuto dell'intervallo nella posizione specificata.
`createDataSourcePivotTable(dataSource)`	`DataSourcePivotTable`	Crea una tabella pivot vuota dall'origine dati, ancorata alla prima cella di questo intervallo.
`createDataSourceTable(dataSource)`	`DataSourceTable`	Crea una tabella di origine dati vuota dall'origine dati, ancorata alla prima cella di questo intervallo.
`createDeveloperMetadataFinder()`	`DeveloperMetadataFinder`	Restituisce un DeveloperMetadataFinderApi per trovare i metadati dello sviluppatore nell'ambito di questo intervallo.
`createFilter()`	`Filter`	Crea un filtro e lo applica all'intervallo specificato sul foglio.
`createPivotTable(sourceData)`	`PivotTable`	Crea una tabella pivot vuota dall'elemento `sourceData` specificato ancorato alla prima cella di questo intervallo.
`createTextFinder(findText)`	`TextFinder`	Crea una ricerca di testo per l'intervallo, che può trovare e sostituire testo in questo intervallo.
`deleteCells(shiftDimension)`	`void`	Elimina questo intervallo di celle.
`expandGroups()`	`Range`	Espande i gruppi compressi il cui intervallo o il pulsante di attivazione/disattivazione del controllo si interseca con questo intervallo.
`getA1Notation()`	`String`	Restituisce una descrizione stringa dell'intervallo, in notazione A1.
`getBackground()`	`String`	Restituisce il colore di sfondo della cella in alto a sinistra nell'intervallo (ad esempio, `'#ffffff'`).
`getBackgroundObject()`	`Color`	Restituisce il colore di sfondo della cella superiore sinistra nell'intervallo.
`getBackgroundObjects()`	`Color[][]`	Restituisce i colori di sfondo delle celle dell'intervallo.
`getBackgrounds()`	`String[][]`	Restituisce i colori di sfondo delle celle dell'intervallo (ad esempio, `'#ffffff'`).
`getBandings()`	`Banding[]`	Restituisce tutte le bande applicate a tutte le celle in questo intervallo.
`getCell(row, column)`	`Range`	Restituisce una determinata cella all'interno di un intervallo.
`getColumn()`	`Integer`	Restituisce la posizione iniziale della colonna per questo intervallo.
`getDataRegion()`	`Range`	Restituisce una copia dell'intervallo espanso nei quattro `Direction` cardinali per coprire tutte le celle adiacenti che contengono dati.
`getDataRegion(dimension)`	`Range`	Restituisce una copia dell'intervallo espanso `Direction.UP` e `Direction.DOWN` se la dimensione specificata è `Dimension.ROWS` oppure `Direction.NEXT` e `Direction.PREVIOUS` se la dimensione è `Dimension.COLUMNS`.
`getDataSourceFormula()`	`DataSourceFormula`	Restituisce `DataSourceFormula` per la prima cella dell'intervallo o `null` se la cella non contiene una formula di origine dati.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Restituisce i `DataSourceFormula` per le celle nell'intervallo.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Visualizza tutte le tabelle pivot dell'origine dati che si intersecano con l'intervallo.
`getDataSourceTables()`	`DataSourceTable[]`	Visualizza tutte le tabelle dell'origine dati che si intersecano con l'intervallo.
`getDataSourceUrl()`	`String`	Restituisce un URL per i dati in questo intervallo, che può essere utilizzato per creare grafici e query.
`getDataTable()`	`DataTable`	Restituisce i dati all'interno di questo oggetto come una tabella dati.
`getDataTable(firstRowIsHeader)`	`DataTable`	Restituisce i dati all'interno di questo intervallo come una tabella di dati.
`getDataValidation()`	`DataValidation`	Restituisce la regola di convalida dei dati per la cella superiore sinistra dell'intervallo.
`getDataValidations()`	`DataValidation[][]`	Restituisce le regole di convalida dei dati per tutte le celle dell'intervallo.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Restituisce i metadati dello sviluppatore associati a questo intervallo.
`getDisplayValue()`	`String`	Restituisce il valore visualizzato della cella superiore sinistra dell'intervallo.
`getDisplayValues()`	`String[][]`	Restituisce la griglia rettangolare di valori per questo intervallo.
`getFilter()`	`Filter`	Restituisce il filtro nel foglio a cui appartiene questo intervallo oppure `null` se non è presente alcun filtro nel foglio.
`getFontColorObject()`	`Color`	Restituisce il colore del carattere della cella nell'angolo superiore sinistro dell'intervallo.
`getFontColorObjects()`	`Color[][]`	Restituisce i colori dei caratteri delle celle dell'intervallo.
`getFontFamilies()`	`String[][]`	Restituisce le famiglie di caratteri delle celle dell'intervallo.
`getFontFamily()`	`String`	Restituisce la famiglia di caratteri della cella nell'angolo superiore sinistro dell'intervallo.
`getFontLine()`	`String`	Restituisce lo stile della riga della cella nell'angolo in alto a sinistra dell'intervallo (`'underline'`, `'line-through'` o `'none'`).
`getFontLines()`	`String[][]`	Restituisce lo stile della linea delle celle nell'intervallo (`'underline'`, `'line-through'` o `'none'`).
`getFontSize()`	`Integer`	Restituisce la dimensione del carattere in punti della cella nell'angolo superiore sinistro dell'intervallo.
`getFontSizes()`	`Integer[][]`	Restituisce le dimensioni dei caratteri delle celle dell'intervallo.
`getFontStyle()`	`String`	Restituisce lo stile del carattere (`'italic'` o `'normal'`) della cella nell'angolo in alto a sinistra dell'intervallo.
`getFontStyles()`	`String[][]`	Restituisce gli stili di carattere delle celle dell'intervallo.
`getFontWeight()`	`String`	Restituisce lo spessore del carattere (normale/grassetto) della cella nell'angolo superiore sinistro dell'intervallo.
`getFontWeights()`	`String[][]`	Restituisce lo spessore del carattere delle celle dell'intervallo.
`getFormula()`	`String`	Restituisce la formula (notazione A1) per la cella in alto a sinistra dell'intervallo o una stringa vuota se la cella è vuota o non contiene una formula.
`getFormulaR1C1()`	`String`	Restituisce la formula (notazione R1C1) per una data cella o `null` se nessuna.
`getFormulas()`	`String[][]`	Restituisce le formule (notazione A1) per le celle dell'intervallo.
`getFormulasR1C1()`	`String[][]`	Restituisce le formule (notazione R1C1) per le celle dell'intervallo.
`getGridId()`	`Integer`	Restituisce l'ID griglia del foglio principale dell'intervallo.
`getHeight()`	`Integer`	Restituisce l'altezza dell'intervallo.
`getHorizontalAlignment()`	`String`	Restituisce l'allineamento orizzontale del testo (sinistra/centro/destra) della cella nell'angolo in alto a sinistra dell'intervallo.
`getHorizontalAlignments()`	`String[][]`	Restituisce gli allineamenti orizzontali delle celle dell'intervallo.
`getLastColumn()`	`Integer`	Restituisce la posizione finale della colonna.
`getLastRow()`	`Integer`	Restituisce la posizione della riga finale.
`getMergedRanges()`	`Range[]`	Restituisce un array di oggetti `Range` che rappresenta le celle unite che si trovano completamente all'interno dell'intervallo corrente o che contengono almeno una cella nell'intervallo corrente.
`getNextDataCell(direction)`	`Range`	Partendo dalla cella della prima colonna e riga dell'intervallo, restituisce la cella successiva nella direzione data che corrisponde al bordo di un intervallo contiguo di celle contenenti dati al loro interno o alla cella sul bordo del foglio di lavoro in quella direzione.
`getNote()`	`String`	Restituisce la nota associata all'intervallo specificato.
`getNotes()`	`String[][]`	Restituisce le note associate alle celle dell'intervallo.
`getNumColumns()`	`Integer`	Restituisce il numero di colonne in questo intervallo.
`getNumRows()`	`Integer`	Restituisce il numero di righe in questo intervallo.
`getNumberFormat()`	`String`	Visualizza la formattazione del numero o della data della cella in alto a sinistra dell'intervallo specificato.
`getNumberFormats()`	`String[][]`	Restituisce il formato numerico o data per le celle dell'intervallo.
`getRichTextValue()`	`RichTextValue`	Restituisce il valore RTF per la cella superiore sinistra dell'intervallo o `null` se il valore della cella non è testo.
`getRichTextValues()`	`RichTextValue[][]`	Restituisce i valori RTF per le celle dell'intervallo.
`getRow()`	`Integer`	Restituisce la posizione della riga per questo intervallo.
`getRowIndex()`	`Integer`	Restituisce la posizione della riga per questo intervallo.
`getSheet()`	`Sheet`	Restituisce il foglio a cui appartiene questo intervallo.
`getTextDirection()`	`TextDirection`	Restituisce la direzione del testo della cella superiore sinistra dell'intervallo.
`getTextDirections()`	`TextDirection[][]`	Restituisce le direzioni del testo per le celle dell'intervallo.
`getTextRotation()`	`TextRotation`	Restituisce le impostazioni di rotazione del testo per la cella superiore sinistra dell'intervallo.
`getTextRotations()`	`TextRotation[][]`	Restituisce le impostazioni di rotazione del testo per le celle dell'intervallo.
`getTextStyle()`	`TextStyle`	Restituisce lo stile di testo per la cella superiore sinistra dell'intervallo.
`getTextStyles()`	`TextStyle[][]`	Restituisce gli stili di testo per le celle dell'intervallo.
`getValue()`	`Object`	Restituisce il valore della cella in alto a sinistra nell'intervallo.
`getValues()`	`Object[][]`	Restituisce la griglia rettangolare di valori per questo intervallo.
`getVerticalAlignment()`	`String`	Restituisce l'allineamento verticale (superiore/medio/basso) della cella nell'angolo superiore sinistro dell'intervallo.
`getVerticalAlignments()`	`String[][]`	Restituisce gli allineamenti verticali delle celle dell'intervallo.
`getWidth()`	`Integer`	Restituisce la larghezza dell'intervallo nelle colonne.
`getWrap()`	`Boolean`	Restituisce se il testo nella cella va a capo.
`getWrapStrategies()`	`WrapStrategy[][]`	Restituisce le strategie di testo a capo per le celle dell'intervallo.
`getWrapStrategy()`	`WrapStrategy`	Restituisce la strategia di testo a capo per la cella superiore sinistra dell'intervallo.
`getWraps()`	`Boolean[][]`	Restituisce un valore che indica se il testo nelle celle deve andare a capo.
`insertCells(shiftDimension)`	`Range`	Inserisce celle vuote in questo intervallo.
`insertCheckboxes()`	`Range`	Inserisce le caselle di controllo in ogni cella dell'intervallo, configurata con `true` per selezionata e `false` per deselezionata.
`insertCheckboxes(checkedValue)`	`Range`	Inserisce caselle di controllo in ogni cella dell'intervallo, configurata con un valore personalizzato per selezionata e la stringa vuota per deselezionata.
`insertCheckboxes(checkedValue, uncheckedValue)`	`Range`	Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e non selezionati.
`isBlank()`	`Boolean`	Restituisce `true` se l'intervallo è completamente vuoto.
`isChecked()`	`Boolean`	Indica se la casella di controllo di tutte le celle dell'intervallo è "selezionata".
`isEndColumnBounded()`	`Boolean`	Determina se la fine dell'intervallo è associata a una determinata colonna.
`isEndRowBounded()`	`Boolean`	Determina se la fine dell'intervallo è associata a una determinata riga.
`isPartOfMerge()`	`Boolean`	Restituisce `true` se le celle nell'intervallo corrente si sovrappongono a eventuali celle unite.
`isStartColumnBounded()`	`Boolean`	Determina se l'inizio dell'intervallo è associato a una determinata colonna.
`isStartRowBounded()`	`Boolean`	Determina se l'inizio dell'intervallo è associato a una determinata riga.
`merge()`	`Range`	Unisce le celle dell'intervallo in un unico blocco.
`mergeAcross()`	`Range`	Unisci le celle dell'intervallo nelle colonne dell'intervallo.
`mergeVertically()`	`Range`	Unisce insieme le celle dell'intervallo.
`moveTo(target)`	`void`	Taglia e incolla (sia il formato che i valori) da questo intervallo all'intervallo target.
`offset(rowOffset, columnOffset)`	`Range`	Restituisce un nuovo intervallo che viene spostato da questo intervallo in base al numero specificato di righe e colonne (che può essere negativo).
`offset(rowOffset, columnOffset, numRows)`	`Range`	Restituisce un nuovo intervallo relativo all'intervallo corrente il cui punto in alto a sinistra è spostato rispetto all'intervallo corrente dalle righe e colonne specificate e con l'altezza specificata nelle celle.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Restituisce un nuovo intervallo relativo all'intervallo corrente il cui punto in alto a sinistra è spostato rispetto all'intervallo corrente dalle righe e colonne specificate e con l'altezza e la larghezza specificate nelle celle.
`protect()`	`Protection`	Crea un oggetto in grado di proteggere l'intervallo dalla modifica, se non dagli utenti che dispongono dell'autorizzazione.
`randomize()`	`Range`	Randomizza l'ordine delle righe nell'intervallo specificato.
`removeCheckboxes()`	`Range`	Rimuove tutte le caselle di controllo dall'intervallo.
`removeDuplicates()`	`Range`	Rimuove le righe in questo intervallo che contengono valori che sono duplicati di valori in qualsiasi riga precedente.
`removeDuplicates(columnsToCompare)`	`Range`	Rimuove le righe in questo intervallo che contengono valori nelle colonne specificate che sono duplicati di valori di qualsiasi riga precedente.
`setBackground(color)`	`Range`	Imposta il colore di sfondo di tutte le celle dell'intervallo nella notazione CSS (come `'#ffffff'` o `'white'`).
`setBackgroundObject(color)`	`Range`	Imposta il colore di sfondo di tutte le celle dell'intervallo.
`setBackgroundObjects(color)`	`Range`	Imposta una griglia rettangolare di colori di sfondo (devono corrispondere alle dimensioni di questo intervallo).
`setBackgroundRGB(red, green, blue)`	`Range`	Imposta lo sfondo sul colore specificato utilizzando valori RGB (numeri interi compresi tra 0 e 255 inclusi).
`setBackgrounds(color)`	`Range`	Imposta una griglia rettangolare di colori di sfondo (devono corrispondere alle dimensioni di questo intervallo).
`setBorder(top, left, bottom, right, vertical, horizontal)`	`Range`	Imposta la proprietà del bordo.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`Range`	Imposta la proprietà del bordo con colore e/o stile.
`setDataValidation(rule)`	`Range`	Imposta una regola di convalida dei dati per tutte le celle dell'intervallo.
`setDataValidations(rules)`	`Range`	Imposta le regole di convalida dei dati per tutte le celle dell'intervallo.
`setFontColor(color)`	`Range`	Imposta il colore del carattere nella notazione CSS (ad esempio `'#ffffff'` o `'white'`).
`setFontColorObject(color)`	`Range`	Imposta il colore del carattere dell'intervallo specificato.
`setFontColorObjects(colors)`	`Range`	Consente di impostare una griglia rettangolare di colori dei caratteri (devono corrispondere alle dimensioni di questo intervallo).
`setFontColors(colors)`	`Range`	Consente di impostare una griglia rettangolare di colori dei caratteri (devono corrispondere alle dimensioni di questo intervallo).
`setFontFamilies(fontFamilies)`	`Range`	Imposta una griglia rettangolare di famiglie di caratteri (le dimensioni devono corrispondere a questo intervallo).
`setFontFamily(fontFamily)`	`Range`	Imposta la famiglia di caratteri, ad esempio "Arial" o "Helvetica".
`setFontLine(fontLine)`	`Range`	Imposta lo stile della linea del carattere per l'intervallo specificato (`'underline'`, `'line-through'` o `'none'`).
`setFontLines(fontLines)`	`Range`	Imposta una griglia rettangolare di stili di linea (devono corrispondere alle dimensioni di questo intervallo).
`setFontSize(size)`	`Range`	Imposta la dimensione del carattere, dove la dimensione corrisponde alla dimensione in punti da utilizzare.
`setFontSizes(sizes)`	`Range`	Imposta una griglia rettangolare di dimensioni carattere (devono corrispondere alle dimensioni di questo intervallo).
`setFontStyle(fontStyle)`	`Range`	Imposta lo stile del carattere per l'intervallo specificato (`'italic'` o `'normal'`).
`setFontStyles(fontStyles)`	`Range`	Imposta una griglia rettangolare di stili dei caratteri (devono corrispondere alle dimensioni di questo intervallo).
`setFontWeight(fontWeight)`	`Range`	Imposta lo spessore del carattere per l'intervallo specificato (normale/grassetto).
`setFontWeights(fontWeights)`	`Range`	Imposta una griglia rettangolare di spessori dei caratteri (devono corrispondere alle dimensioni di questo intervallo).
`setFormula(formula)`	`Range`	Aggiorna la formula per questo intervallo.
`setFormulaR1C1(formula)`	`Range`	Aggiorna la formula per questo intervallo.
`setFormulas(formulas)`	`Range`	Imposta una griglia rettangolare di formule (devono corrispondere alle dimensioni di questo intervallo).
`setFormulasR1C1(formulas)`	`Range`	Imposta una griglia rettangolare di formule (devono corrispondere alle dimensioni di questo intervallo).
`setHorizontalAlignment(alignment)`	`Range`	Imposta l'allineamento orizzontale (da sinistra a destra) per l'intervallo specificato (sinistra/centro/destra).
`setHorizontalAlignments(alignments)`	`Range`	Imposta una griglia rettangolare di allineamenti orizzontali.
`setNote(note)`	`Range`	Imposta la nota sul valore specificato.
`setNotes(notes)`	`Range`	Imposta una griglia rettangolare di note (devono corrispondere alle dimensioni di questo intervallo).
`setNumberFormat(numberFormat)`	`Range`	Imposta il formato numerico o data sulla stringa di formattazione specificata.
`setNumberFormats(numberFormats)`	`Range`	Imposta una griglia rettangolare di formati numerici o di data (devono corrispondere alle dimensioni di questo intervallo).
`setRichTextValue(value)`	`Range`	Imposta il valore RTF per le celle dell'intervallo.
`setRichTextValues(values)`	`Range`	Imposta una griglia rettangolare di valori RTF.
`setShowHyperlink(showHyperlink)`	`Range`	Consente di impostare se l'intervallo deve mostrare o meno i link ipertestuali.
`setTextDirection(direction)`	`Range`	Imposta la direzione del testo per le celle nell'intervallo.
`setTextDirections(directions)`	`Range`	Imposta una griglia rettangolare di direzioni del testo.
`setTextRotation(degrees)`	`Range`	Consente di impostare le impostazioni di rotazione del testo per le celle dell'intervallo.
`setTextRotation(rotation)`	`Range`	Consente di impostare le impostazioni di rotazione del testo per le celle dell'intervallo.
`setTextRotations(rotations)`	`Range`	Imposta una griglia rettangolare di rotazioni del testo.
`setTextStyle(style)`	`Range`	Imposta lo stile di testo per le celle dell'intervallo.
`setTextStyles(styles)`	`Range`	Imposta una griglia rettangolare di stili di testo.
`setValue(value)`	`Range`	Imposta il valore dell'intervallo.
`setValues(values)`	`Range`	Imposta una griglia rettangolare di valori (devono corrispondere alle dimensioni di questo intervallo).
`setVerticalAlignment(alignment)`	`Range`	Imposta l'allineamento verticale (dall'alto verso il basso) per l'intervallo specificato (in alto/al centro/in basso).
`setVerticalAlignments(alignments)`	`Range`	Imposta una griglia rettangolare di allineamenti verticali (devono corrispondere alle dimensioni di questo intervallo).
`setVerticalText(isVertical)`	`Range`	Consente di impostare se sovrapporre o meno il testo per le celle dell'intervallo.
`setWrap(isWrapEnabled)`	`Range`	Imposta il ritorno a capo delle celle dell'intervallo specificato.
`setWrapStrategies(strategies)`	`Range`	Imposta una griglia rettangolare di strategie di aggregazione.
`setWrapStrategy(strategy)`	`Range`	Imposta la strategia di testo a capo per le celle dell'intervallo.
`setWraps(isWrapEnabled)`	`Range`	Consente di impostare una griglia rettangolare di criteri per il ritorno a capo automatico (deve corrispondere alle dimensioni di questo intervallo).
`shiftColumnGroupDepth(delta)`	`Range`	Modifica la profondità di raggruppamento delle colonne dell'intervallo in base al valore specificato.
`shiftRowGroupDepth(delta)`	`Range`	Modifica la profondità di raggruppamento delle righe dell'intervallo in base al valore specificato.
`sort(sortSpecObj)`	`Range`	Ordina le celle nell'intervallo specificato, per colonna e ordine specificati.
`splitTextToColumns()`	`void`	Suddivide una colonna di testo in più colonne in base a un delimitatore rilevato automaticamente.
`splitTextToColumns(delimiter)`	`void`	Suddivide una colonna di testo in più colonne utilizzando la stringa specificata come delimitatore personalizzato.
`splitTextToColumns(delimiter)`	`void`	Suddivide una colonna di testo in più colonne in base al delimitatore specificato.
`trimWhitespace()`	`Range`	Modifica gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella dell'intervallo.
`uncheck()`	`Range`	Modifica lo stato delle caselle di controllo nell'intervallo in "Deselezionata".

Metodi deprecati

Metodo	Tipo restituito	Breve descrizione
`getFontColor()`	`String`	Restituisce il colore del carattere della cella nell'angolo in alto a sinistra dell'intervallo, nella notazione CSS (ad esempio `'#ffffff'` o `'white'`).
`getFontColors()`	`String[][]`	Restituisce i colori dei caratteri delle celle dell'intervallo nella notazione CSS (come `'#ffffff'` o `'white'`).

Documentazione dettagliata

`activate()`

Imposta l'intervallo specificato come active range, con la cella in alto a sinistra nell'intervallo come current cell.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:D10');
range.activate();

var selection = sheet.getSelection();
// Current cell: A1
var currentCell = selection.getCurrentCell();
// Active Range: A1:D10
var activeRange = selection.getActiveRange();

Ritorni

Range: questo intervallo, per il concatenamento.

`activateAsCurrentCell()`

Imposta la cella specificata come current cell.

Se la cella specificata è presente in un intervallo esistente, questo diventa l'intervallo attivo con la cella come cella corrente.

Se la cella specificata non è presente in alcun intervallo esistente, la selezione esistente viene rimossa e la cella diventa la cella corrente e l'intervallo attivo.

Nota: il valore Range specificato deve essere composto da una cella, altrimenti genera un'eccezione.

// Gets the first sheet of the spreadsheet.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];

// Gets the cell B5 and sets it as the active cell.
var range = sheet.getRange('B5');
var currentCell = range.activateAsCurrentCell();

// Logs the activated cell.
console.log(currentCell.getA1Notation());

Ritorni

Range: questo intervallo, per il concatenamento.

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

`addDeveloperMetadata(key)`

Aggiunge all'intervallo i metadati dello sviluppatore con la chiave specificata.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' to the developer metadata for row 2.
range.addDeveloperMetadata('NAME');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());

Parametri

Nome	Tipo	Descrizione
`key`	`String`	La chiave per i nuovi metadati dello sviluppatore.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`addDeveloperMetadata(key, visibility)`

Aggiunge metadati sviluppatore con la chiave e la visibilità specificate all'intervallo.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT'
// for row 2 on Sheet1.
range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getVisibility().toString());

Parametri

Nome	Tipo	Descrizione
`key`	`String`	La chiave per i nuovi metadati dello sviluppatore.
`visibility`	`DeveloperMetadataVisibility`	La visibilità dei nuovi metadati dello sviluppatore.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`addDeveloperMetadata(key, value)`

Aggiunge all'intervallo i metadati dello sviluppatore con la chiave e il valore specificati.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 of Sheet1.
const range = sheet.getRange('2:2');

// Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Gets the metadata and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());

Parametri

Nome	Tipo	Descrizione
`key`	`String`	La chiave per i nuovi metadati dello sviluppatore.
`value`	`String`	Il valore dei nuovi metadati dello sviluppatore.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`addDeveloperMetadata(key, value, visibility)`

Aggiunge all'intervallo i metadati dello sviluppatore con la chiave, il valore e la visibilità specificati.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility
// to PROJECT for row 2 on the sheet.
range.addDeveloperMetadata(
  'NAME',
  'GOOGLE',
  SpreadsheetApp.DeveloperMetadataVisibility.PROJECT);

// Gets the updated metadata info and logs it to the console.
const developerMetaData = range.getDeveloperMetadata()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Parametri

Nome	Tipo	Descrizione
`key`	`String`	La chiave per i nuovi metadati dello sviluppatore.
`value`	`String`	Il valore dei nuovi metadati dello sviluppatore.
`visibility`	`DeveloperMetadataVisibility`	La visibilità dei nuovi metadati dello sviluppatore.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`applyColumnBanding()`

Applica all'intervallo un tema predefinito per le bande di colonna. Per impostazione predefinita, la banding ha il colore dell'intestazione, senza il colore del piè di pagina.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies column banding to row 2.
const colBanding = range.applyColumnBanding();

// Gets the first banding on the sheet and logs the color of the header column.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString());

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

Ritorni

Banding: la nuova banding.

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

`applyColumnBanding(bandingTheme)`

Applica all'intervallo un tema specificato per le bande di colonna. Per impostazione predefinita, le bande hanno il colore dell'intestazione e del piè di pagina.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on the sheet.
const range = sheet.getRange('2:2');

// Applies the INDIGO color banding theme to the columns in row 2.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the first banding on the sheet and logs the color of the second column.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

Parametri

Nome	Tipo	Descrizione
`bandingTheme`	`BandingTheme`	Un tema a colori da applicare alle colonne dell'intervallo.

Ritorni

Banding: la nuova banding.

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

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

Applica un tema specificato per le bande di colonna all'intervallo con le impostazioni di intestazione e piè di pagina specificate.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 12-22 on the sheet.
const range = sheet.getRange('12:22');

// Applies the BLUE color banding theme to rows 12-22.
// Sets the header visibility to false and the footer visibility to true.
const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true);

// Gets the banding color and logs it to the console.
console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());

// Gets the header color object and logs it to the console. Returns null because the header
// visibility is set to false.
console.log(sheet.getBandings()[0].getHeaderColumnColorObject());

// Gets the footer color and logs it to the console.
console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());

Parametri

Nome	Tipo	Descrizione
`bandingTheme`	`BandingTheme`	Un tema a colori da applicare alle colonne dell'intervallo.
`showHeader`	`Boolean`	Se `true`, il colore dell'intestazione del tema a bande viene applicato alla prima colonna.
`showFooter`	`Boolean`	Se `true`, il colore del piè di pagina del tema con bande viene applicato all'ultima colonna.

Ritorni

Banding: la nuova banding.

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

`applyRowBanding()`

Applica all'intervallo un tema predefinito per le bande di riga. Per impostazione predefinita, la banding ha il colore dell'intestazione, senza il colore del piè di pagina.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies row banding to rows 1-30.
range.applyRowBanding();

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

Ritorni

Banding: banding.

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

`applyRowBanding(bandingTheme)`

Applica all'intervallo un tema specificato per le bande di riga. Per impostazione predefinita, la banding ha il colore dell'intestazione, senza il colore del piè di pagina.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding theme to rows 1-30.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO);

// Gets the hex color of the second banded row.
const secondRowColor = range.getBandings()[0]
                            .getSecondRowColorObject()
                            .asRgbColor()
                            .asHexString();

// Logs the hex color to console.
console.log(secondRowColor);

Parametri

Nome	Tipo	Descrizione
`bandingTheme`	`BandingTheme`	Un tema a colori da applicare alle righe nell'intervallo.

Ritorni

Banding: la nuova banding.

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

`applyRowBanding(bandingTheme, showHeader, showFooter)`

Applica all'intervallo con impostazioni di intestazione e piè di pagina un tema specificato per le bande di riga.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets rows 1-30 on Sheet1.
const range = sheet.getRange('1:30');

// Applies the INDIGO row banding to rows 1-30 and
// specifies to hide the header and show the footer.
range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);

Parametri

Nome	Tipo	Descrizione
`bandingTheme`	`BandingTheme`	Un tema a colori da applicare alle righe nell'intervallo.
`showHeader`	`Boolean`	Se `true`, alla prima riga viene applicato il colore dell'intestazione del tema a bande.
`showFooter`	`Boolean`	Se `true`, il colore del piè di pagina del tema a bande viene applicato all'ultima riga.

Ritorni

Banding: la nuova banding.

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

`autoFill(destination, series)`

Compila il campo destinationRange con i dati in base ai dati compresi in questo intervallo. I nuovi valori sono inoltre determinati dal tipo series specificato. L'intervallo di destinazione deve contenere questo intervallo ed estenderlo in una sola direzione. Ad esempio, quanto segue riempie A1:A20 con una serie di numeri crescenti basati sui valori correnti in A1:A4:

var sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
var sourceRange = sheet.getRange("A1:A4");
// The range to fill with values.
var destination = sheet.getRange("A1:A20");

// Inserts new values in A5:A20, continuing the pattern expressed in A1:A4
sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parametri

Nome	Tipo	Descrizione
`destination`	`Range`	L'intervallo da compilare automaticamente con i valori. L'intervallo di destinazione deve contenere questo intervallo ed estenderlo in una sola direzione (verso l'alto, verso il basso, verso sinistra o verso destra).
`series`	`AutoFillSeries`	Il tipo di serie autoFill da utilizzare per calcolare nuovi valori. L'effetto di questa serie varia in base al tipo e alla quantità dei dati di origine.

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

`autoFillToNeighbor(series)`

Calcola un intervallo per riempire con nuovi dati sulla base di celle vicine e lo riempie automaticamente con nuovi valori in base ai dati contenuti in questo intervallo. Questi nuovi valori vengono inoltre determinati dal tipo series specificato.

L'intervallo di destinazione calcolato considera i dati circostanti per determinare dove inserire i nuovi valori: se ci sono dati immediatamente a sinistra o a destra di una colonna che viene compilata automaticamente, i nuovi valori si estendono solo fino a questi dati adiacenti.

Ad esempio, se A1:A20 viene compilato con una serie di numeri crescenti e questo metodo viene richiamato nell'intervallo B1:B4 che contiene una serie di date, i nuovi valori vengono inseriti solo in B5:B20. In questo modo, questi nuovi valori si "attengono" alle celle che contengono i valori nella colonna A.

var sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
var sourceRange = sheet.getRange("B1:B4");

// Results in B5:B20 having values [1/5/2017, ... 1/20/2017]
sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);

Parametri

Nome	Tipo	Descrizione
`series`	`AutoFillSeries`	Il tipo di serie autoFill da utilizzare per calcolare nuovi valori. L'effetto di questa serie varia in base al tipo e alla quantità dei dati di origine.

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

`breakApart()`

Suddividi nuovamente le celle a più colonne dell'intervallo in singole celle.

Chiamare questa funzione in un intervallo equivale a selezionare un intervallo e a fare clic su Formato > Unisci celle > Dividi.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Unmerges the range A1:C6 into individual cells.
range.breakApart();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`canEdit()`

Determina se l'utente è autorizzato a modificare ogni cella dell'intervallo. Il proprietario del foglio di lavoro è sempre in grado di modificare intervalli e fogli protetti.

// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets
// spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6 on Sheet1.
const range = sheet.getRange('A1:C6');

// Logs whether the user has permission to edit every cell in the range.
console.log(range.canEdit());

Ritorni

Boolean: true se l'utente è autorizzato a modificare ogni cella dell'intervallo; in caso contrario false.

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

`check()`

Modifica lo stato delle caselle di controllo nell'intervallo in "Selezionata". Ignora le celle nell'intervallo che attualmente non contengono il valore selezionato o deselezionato configurato.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'checked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`clear()`

Cancella l'intervallo di contenuti e formati.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clear();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`clear(options)`

Cancella l'intervallo di contenuti, il formato, le regole di convalida dei dati e/o i commenti, come specificato con le opzioni avanzate specificate. Per impostazione predefinita, tutti i dati vengono cancellati.

// The code below clears range C2:G7 in the active sheet, but preserves the format,
// data validation rules, and comments.
SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});

Parametri

Nome	Tipo	Descrizione
`options`	`Object`	Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito.

Parametri avanzati

Nome	Tipo	Descrizione
`commentsOnly`	`Boolean`	Indica se cancellare solo i commenti.
`contentsOnly`	`Boolean`	Indica se cancellare solo i contenuti.
`formatOnly`	`Boolean`	Indica se cancellare solo il formato. Tieni presente che la cancellazione del formato comporta anche la cancellazione delle regole di convalida dei dati.
`validationsOnly`	`Boolean`	Indica se cancellare solo le regole di convalida dei dati.
`skipFilteredRows`	`Boolean`	Indica se evitare di cancellare le righe filtrate.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`clearContent()`

Cancella i contenuti dell'intervallo, senza modificare la formattazione.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearContent();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`clearDataValidations()`

Cancella le regole di convalida dei dati per l'intervallo.

// Clear the data validation rules for cells A1:B5.
var range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`clearFormat()`

Cancella la formattazione per questo intervallo.

In questo modo viene cancellata la formattazione del testo della cella o delle celle nell'intervallo, ma non vengono reimpostate le regole di formattazione dei numeri.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearFormat();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`clearNote()`

Cancella la nota nella cella o nelle celle specificate.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.clearNote();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`collapseGroups()`

Comprime tutti i gruppi che sono interamente contenuti all'interno dell'intervallo. Se nessun gruppo è completamente all'interno dell'intervallo, viene compresso il gruppo espanso più profondo che rientra parzialmente nell'intervallo.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are collapsed.
range.collapseGroups();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`copyFormatToRange(gridId, column, columnEnd, row, rowEnd)`

Copia la formattazione dell'intervallo nella posizione specificata. Se la destinazione è maggiore o minore dell'intervallo di origine, l'origine viene ripetuta o troncata di conseguenza. Tieni presente che questo metodo copia solo la formattazione.

Per una descrizione dettagliata del parametro gridId, consulta getGridId().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId
// of a sheet by calling sheet.getSheetId() or range.getGridId().
range.copyFormatToRange(1555299895, 4, 6, 4, 6);

Parametri

Nome	Tipo	Descrizione
`gridId`	`Integer`	L'ID univoco del foglio all'interno del foglio di lavoro, indipendentemente dalla posizione.
`column`	`Integer`	La prima colonna dell'intervallo target.
`columnEnd`	`Integer`	La colonna finale dell'intervallo target.
`row`	`Integer`	La riga iniziale dell'intervallo target.
`rowEnd`	`Integer`	La riga finale dell'intervallo target.

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

Vedi anche

getGridId()

`copyFormatToRange(sheet, column, columnEnd, row, rowEnd)`

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the formatting in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyFormatToRange(destination, 4, 6, 4, 6);

Parametri

Nome	Tipo	Descrizione
`sheet`	`Sheet`	Il foglio di destinazione.
`column`	`Integer`	La prima colonna dell'intervallo target.
`columnEnd`	`Integer`	La colonna finale dell'intervallo target.
`row`	`Integer`	La riga iniziale dell'intervallo target.
`rowEnd`	`Integer`	La riga finale dell'intervallo target.

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

`copyTo(destination)`

Copia i dati da un intervallo di celle a un altro intervallo di celle. Vengono copiati entrambi i valori e la formattazione.

// The code below copies the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5);
rangeToCopy.copyTo(sheet.getRange(1, 6));

Parametri

Nome	Tipo	Descrizione
`destination`	`Range`	Un intervallo di destinazione in cui copiare; è pertinente solo la posizione della cella superiore sinistra.

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

`copyTo(destination, copyPasteType, transposed)`

Copia i dati da un intervallo di celle a un altro intervallo di celle.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES,
false);

Parametri

Nome	Tipo	Descrizione
`destination`	`Range`	Un intervallo di destinazione in cui copiare; è pertinente solo la posizione della cella superiore sinistra.
`copyPasteType`	`CopyPasteType`	Un tipo che specifica in che modo i contenuti dell'intervallo vengono incollati nella destinazione.
`transposed`	`Boolean`	Indica se l'intervallo deve essere incollato nel suo orientamento trasposto.

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

`copyTo(destination, options)`

Copia i dati da un intervallo di celle a un altro intervallo di celle. Per impostazione predefinita, vengono copiati sia i valori che la formattazione, ma puoi eseguire l'override utilizzando argomenti avanzati.

// The code below copies only the values of the first 5 columns over to the 6th column.
var sheet = SpreadsheetApp.getActiveSheet();
sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});

Parametri

Nome	Tipo	Descrizione
`destination`	`Range`	Un intervallo di destinazione in cui copiare; è pertinente solo la posizione della cella superiore sinistra.
`options`	`Object`	Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito.

Parametri avanzati

Nome	Tipo	Descrizione
`formatOnly`	`Boolean`	indica che deve essere copiato solo il formato
`contentsOnly`	`Boolean`	indica che devono essere copiati solo i contenuti

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

`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`

Copia il contenuto dell'intervallo nella posizione specificata. Se la destinazione è maggiore o minore dell'intervallo di origine, l'origine viene ripetuta o troncata di conseguenza.

Per una descrizione dettagliata del parametro gridId, consulta getGridId().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the sheet with gridId 0
range.copyValuesToRange(0, 4, 6, 4, 6);

Parametri

Nome	Tipo	Descrizione
`gridId`	`Integer`	L'ID univoco del foglio all'interno del foglio di lavoro, indipendentemente dalla posizione.
`column`	`Integer`	La prima colonna dell'intervallo target.
`columnEnd`	`Integer`	La colonna finale dell'intervallo target.
`row`	`Integer`	La riga iniziale dell'intervallo target.
`rowEnd`	`Integer`	La riga finale dell'intervallo target.

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

Vedi anche

getGridId()

`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`

Copia il contenuto dell'intervallo nella posizione specificata. Se la destinazione è maggiore o minore dell'intervallo di origine, l'origine viene ripetuta o troncata di conseguenza.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var source = ss.getSheets()[0];
var destination = ss.getSheets()[1];

var range = source.getRange("B2:D4");

// This copies the data in B2:D4 in the source sheet to
// D4:F6 in the second sheet
range.copyValuesToRange(destination, 4, 6, 4, 6);

Parametri

Nome	Tipo	Descrizione
`sheet`	`Sheet`	Il foglio di destinazione.
`column`	`Integer`	La prima colonna dell'intervallo target.
`columnEnd`	`Integer`	La colonna finale dell'intervallo target.
`row`	`Integer`	La riga iniziale dell'intervallo target.
`rowEnd`	`Integer`	La riga finale dell'intervallo target.

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

`createDataSourcePivotTable(dataSource)`

Crea una tabella pivot vuota dall'origine dati, ancorata alla prima cella di questo intervallo.

Questo esempio mostra come creare e configurare una nuova tabella pivot dell'origine dati.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var pivotTable = anchorCell.createDataSourcePivotTable(dataSource);
pivotTable.addRowGroup('dataColumnA');
pivotTable.addColumnGroup('dataColumnB');
pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM);
pivotTable.addFilter('dataColumnA',
                     SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());

Parametri

Nome	Tipo	Descrizione
`dataSource`	`DataSource`	L'origine dati da cui creare la tabella pivot.

Ritorni

DataSourcePivotTable: la tabella pivot dell'origine dati appena creata.

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

`createDataSourceTable(dataSource)`

Crea una tabella di origine dati vuota dall'origine dati, ancorata alla prima cella di questo intervallo.

Questo esempio mostra come creare e configurare una nuova tabella di origine dati.

var spreadsheet = SpreadsheetApp.getActiveSpreadsheet();
var anchorCell = spreadsheet.getSheets()[0].getRange('A1');
var dataSource = spreadsheet.getDataSources()[0];

var dataSourceTable = anchorCell.createDataSourceTable(dataSource);
    .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC')
    .addSortSpec('dataColumnA', /* ascending= *\/ true)
    .addSortSpec('dataColumnB', /* ascending= *\/ false);

Parametri

Nome	Tipo	Descrizione
`dataSource`	`DataSource`	L'origine dati da cui creare la tabella pivot.

Ritorni

DataSourceTable: la tabella dell'origine dati appena creata.

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

`createDeveloperMetadataFinder()`

Restituisce un DeveloperMetadataFinderApi per trovare i metadati dello sviluppatore nell'ambito di questo intervallo. I metadati rientrano nell'ambito dell'intervallo solo se sono interamente contenuti all'interno di quell'intervallo. Ad esempio, i metadati associati alla riga "3:3" non rientrano nell'ambito di un intervallo "A1:D5", ma rientrano nell'ambito di un intervallo "1:5".

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:C6.
const range = sheet.getRange('A1:C6');

// Creates a developer metadata finder to search for metadata in the scope of this range.
const developerMetaDataFinder = range.createDeveloperMetadataFinder();

// Logs information about the developer metadata finder to the console.
const developerMetaData = developerMetaDataFinder.find()[0];
console.log(developerMetaData.getKey());
console.log(developerMetaData.getValue());
console.log(developerMetaData.getVisibility().toString());

Ritorni

DeveloperMetadataFinder: uno sviluppatore che si occupa di ricerca dei metadati per cercare metadati che rientrano nell'ambito di questo intervallo.

`createFilter()`

Crea un filtro e lo applica all'intervallo specificato sul foglio. Non puoi creare più di un filtro in un foglio. Per accedere al filtro e modificarlo dopo averlo creato, utilizza getFilter() o Sheet.getFilter().

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");

// Creates a new filter and applies it to the range A1:C20 on the active sheet.
function createFilter() {
  range.createFilter();
}
// Gets the filter and applies criteria that only shows cells that aren't empty.
function getFilterAddCriteria() {
  let filter = range.getFilter();
  let criteria = SpreadsheetApp.newFilterCriteria()
    .whenCellNotEmpty()
    .build();
  filter.setColumnFilterCriteria(2, criteria);
}

Utilizza questo metodo per creare filtri per Grid fogli, il tipo predefinito di foglio. I fogli della griglia sono fogli non connessi a un database. Per creare altri tipi di filtri, consulta quanto segue:

Crea un filtro tabella pivot con PivotTable.addFilter(sourceDataColumn, filterCriteria)
Crea un filtro per un foglio connesso a un database con DataSourceSheet.addFilter(columnName, filterCriteria)
Crea un filtro per una tabella pivot connessa a un database con DataSourcePivotTable.addFilter(columnName, filterCriteria)

Ritorni

Filter: il nuovo filtro.

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

`createPivotTable(sourceData)`

Crea una tabella pivot vuota dall'elemento sourceData specificato ancorato alla prima cella di questo intervallo.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A1 as a range in order to place the pivot table.
const range = sheet.getRange('A1');

// Gets the range of the source data for the pivot table.
const dataRange = sheet.getRange('E12:G20');

// Creates an empty pivot table from the specified source data.
const pivotTable = range.createPivotTable(dataRange);

// Logs the values from the pivot table's source data to the console.
console.log(pivotTable.getSourceDataRange().getValues());

Parametri

Nome	Tipo	Descrizione
`sourceData`	`Range`	I dati da cui creare la tabella pivot.

Ritorni

PivotTable: il nuovo PivotTable.

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

`createTextFinder(findText)`

Crea una ricerca di testo per l'intervallo, che può trovare e sostituire testo in questo intervallo.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// Creates  a text finder for the range.
var textFinder = range.createTextFinder('dog');

// Returns the first occurrence of 'dog'.
var firstOccurrence = textFinder.findNext();

// Replaces the last found occurrence of 'dog' with 'cat' and returns the number
// of occurrences replaced.
var numOccurrencesReplaced = textFinder.replaceWith('cat');

Parametri

Nome	Tipo	Descrizione
`findText`	`String`	Il testo da cercare.

Ritorni

TextFinder: il valore TextFinder per l'intervallo

`deleteCells(shiftDimension)`

Elimina questo intervallo di celle. I dati esistenti nel foglio lungo la dimensione fornita vengono spostati verso l'intervallo eliminato.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Parametri

Nome	Tipo	Descrizione
`shiftDimension`	`Dimension`	La dimensione in base alla quale spostare i dati esistenti.

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

`expandGroups()`

Espande i gruppi compressi il cui intervallo o il pulsante di attivazione/disattivazione del controllo si interseca con questo intervallo. La posizione dell'opzione di attivazione/disattivazione del controllo è l'indice in cui viene visualizzata, subito prima o dopo il gruppo, a seconda delle impostazioni. Se c'è più di un gruppo nella stessa località, il gruppo più basso viene espanso.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// All row and column groups within the range are expanded.
range.expandGroups();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`getA1Notation()`

Restituisce una descrizione stringa dell'intervallo, in notazione A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange(1, 1, 2, 5);

// Logs "A1:E2"
Logger.log(range.getA1Notation());

Ritorni

String: la descrizione della stringa dell'intervallo nella notazione A1.

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

`getBackground()`

Restituisce il colore di sfondo della cella in alto a sinistra nell'intervallo (ad esempio, '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackground());

Ritorni

String: il codice del colore dello sfondo.

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

`getBackgroundObject()`

Restituisce il colore di sfondo della cella superiore sinistra nell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

Ritorni

Color: il colore di sfondo della cella superiore sinistra dell'intervallo.

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

`getBackgroundObjects()`

Restituisce i colori di sfondo delle celle dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgroundObjects();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j].asRgbColor().asHexString());
  }
}

Ritorni

Color[][]: una matrice bidimensionale di colori di sfondo.

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

`getBackgrounds()`

Restituisce i colori di sfondo delle celle dell'intervallo (ad esempio, '#ffffff').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var bgColors = range.getBackgrounds();
for (var i in bgColors) {
  for (var j in bgColors[i]) {
    Logger.log(bgColors[i][j]);
  }
}

Ritorni

String[][]: array bidimensionale di codici colore degli sfondi.

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

`getBandings()`

Restituisce tutte le bande applicate a tutte le celle in questo intervallo.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Sets a range.
const range = sheet.getRange('A1:K50');

// Gets the banding info for the range.
const bandings = range.getBandings();

// Logs the second row color for each banding to the console.
for (let banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Ritorni

Banding[]: tutte le bande applicate a tutte le celle in questo intervallo.

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

`getCell(row, column)`

Restituisce una determinata cella all'interno di un intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");

// The row and column here are relative to the range
// getCell(1,1) in this code returns the cell at B2
var cell = range.getCell(1, 1);
Logger.log(cell.getValue());

Parametri

Nome	Tipo	Descrizione
`row`	`Integer`	La riga della cella relativa all'intervallo.
`column`	`Integer`	La colonna della cella relativa all'intervallo.

Ritorni

Range: un intervallo contenente una singola cella alle coordinate specificate.

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

`getColumn()`

Restituisce la posizione iniziale della colonna per questo intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "2.0"
Logger.log(range.getColumn());

Ritorni

Integer: posizione nella colonna iniziale dell'intervallo 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

`getDataRegion()`

Restituisce una copia dell'intervallo espanso nei quattro Direction cardinali per coprire tutte le celle adiacenti che contengono dati. Se l'intervallo è racchiuso da celle vuote che non includono quelle lungo le diagonali, viene restituito l'intervallo stesso. Questa operazione è simile alla selezione dell'intervallo e alla digitazione di Ctrl+A nell'editor.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "B2:D4"
Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());

Ritorni

Range: la regione di dati dell'intervallo o un intervallo per l'intero 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

`getDataRegion(dimension)`

Restituisce una copia dell'intervallo espanso Direction.UP e Direction.DOWN se la dimensione specificata è Dimension.ROWS oppure Direction.NEXT e Direction.PREVIOUS se la dimensione è Dimension.COLUMNS. L'espansione dell'intervallo si basa sul rilevamento dei dati accanto all'intervallo organizzato come una tabella. L'intervallo espanso copre tutte le celle adiacenti contenenti dati al loro interno nella dimensione specificata, inclusi i confini della tabella. Se l'intervallo originale è racchiuso da celle vuote lungo la dimensione specificata, viene restituito l'intervallo stesso. Questo metodo è simile alla selezione dell'intervallo e alla digitazione di Ctrl+Space per le colonne o di Shift+Space per le righe nell'editor.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
sheet.getRange("C2").setValue(100);
sheet.getRange("B3").setValue(100);
sheet.getRange("D3").setValue(100);
sheet.getRange("C4").setValue(100);
// Logs "C2:C4"
Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation());
// Logs "B3:D3"
Logger.log(
    sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());

Parametri

Nome	Tipo	Descrizione
`dimension`	`Dimension`	La dimensione in base alla quale espandere l'intervallo.

Ritorni

Range: la regione di dati dell'intervallo o un intervallo che copre ogni colonna o ogni riga comprendente l'intervallo originale.

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

`getDataSourceFormula()`

Restituisce DataSourceFormula per la prima cella dell'intervallo o null se la cella non contiene una formula di origine dati.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1 on Sheet1.
const range = sheet.getRange('A1');

// Gets the data source formula from cell A1.
const dataSourceFormula = range.getDataSourceFormula();

// Gets the formula.
const formula = dataSourceFormula.getFormula();

// Logs the formula.
console.log(formula);

Ritorni

DataSourceFormula: il valore DataSourceFormula della cella.

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

`getDataSourceFormulas()`

Restituisce i DataSourceFormula per le celle nell'intervallo.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:B5 on Sheet1.
const range = sheet.getRange('A1:B5');

// Gets an array of the data source formulas in the range A1:B5.
const dataSourceFormulas = range.getDataSourceFormulas();

// Logs the first formula in the array.
console.log(dataSourceFormulas[0].getFormula());

Ritorni

DataSourceFormula[]: un array di DataSourceFormula.

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

`getDataSourcePivotTables()`

Visualizza tutte le tabelle pivot dell'origine dati che si intersecano con l'intervallo.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets an array of the data source pivot tables in the range A1:G50.
const dataSourcePivotTables = range.getDataSourcePivotTables();

// Logs the last time that the first pivot table in the array was refreshed.
console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());

Ritorni

DataSourcePivotTable[]: un elenco di tabelle pivot dell'origine dati.

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

`getDataSourceTables()`

Visualizza tutte le tabelle dell'origine dati che si intersecano con l'intervallo.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:G50 on Sheet1.
const range = sheet.getRange('A1:G50');

// Gets the first data source table in the range A1:G50.
const dataSourceTable = range.getDataSourceTables()[0];

// Logs the time of the last completed data execution on the data source table.
console.log(dataSourceTable.getStatus().getLastExecutionTime());

Ritorni

DataSourceTable[]: un elenco di tabelle di origini dati.

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

`getDataSourceUrl()`

Restituisce un URL per i dati in questo intervallo, che può essere utilizzato per creare grafici e query.

Code.gs

function doGet() {
  var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c');
  var sheet = ss.getSheetByName('ContinentData');
  var range = sheet.getRange('A1:B8');

  var template = HtmlService.createTemplateFromFile('piechart');
  template.dataSourceUrl = range.getDataSourceUrl();
  return template.evaluate();
}

piechart.html

<!DOCTYPE html>
<html>
  <head>
    <!--Load the AJAX API-->
    <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script>
    <script type="text/javascript">
      // Load the Visualization API and the corechart package.
      google.charts.load('current', {'packages': ['corechart']});

      // Set a callback to run when the Google Visualization API is loaded.
      google.charts.setOnLoadCallback(queryData);

      function queryData() {
        var query = new google.visualization.Query('<?= dataSourceUrl ?>');
        query.send(drawChart);
      }

      // Callback that creates and populates a data table,
      // instantiates the pie chart, passes in the data and
      // draws it.
      function drawChart(response) {
        if (response.isError()) {
          alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage());
          return;
        }
        var data = response.getDataTable();

        // Set chart options.
        var options = {
          title: 'Population by Continent',
          width: 400,
          height: 300
        };

        // Instantiate and draw the chart, passing in some options.
        var chart = new google.visualization.PieChart(document.getElementById('chart_div'));
        chart.draw(data, options);
      }
    </script>
  </head>
  <body>
    <!-- Div that holds the pie chart. -->
    <div id="chart_div"></div>
  </body>
</html>

Ritorni

String: un URL per questo intervallo come origine dati che può essere trasmesso ad altre API, ad esempio i grafici.

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

`getDataTable()`

Restituisce i dati all'interno di questo oggetto come una tabella dati.

// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file,
// use SpreadsheetApp.getActiveSpreadsheet().
// TODO(developer): Replace the ID with your own.
const ss = SpreadsheetApp.openById('abc123456');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:B7 on Sheet1.
const range = sheet.getRange('A1:B7');

// Gets the range A1:B7 as a data table. The values in each column must be of the same type.
const datatable = range.getDataTable();

// Uses the Charts service to build a bar chart from the data table.
// This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Chart Title Here')
                  .build();

Ritorni

DataTable: i dati sotto forma di tabella di dati.

`getDataTable(firstRowIsHeader)`

Restituisce i dati all'interno di questo intervallo come una tabella di dati.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:B7");

// Calling this method with "true" sets the first line to be the title of the axes
var datatable = range.getDataTable(true);

// Note that this doesn't build an EmbeddedChart, so you can't just use
// Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead.
var chart = Charts.newBarChart()
    .setDataTable(datatable)
    .setOption("title", "Your Title Here")
    .build();

Parametri

Nome	Tipo	Descrizione
`firstRowIsHeader`	`Boolean`	Indica se considerare la prima riga come un'intestazione.

Ritorni

DataTable: i dati sotto forma di tabella di dati.

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

`getDataValidation()`

Restituisce la regola di convalida dei dati per la cella superiore sinistra dell'intervallo. Se la convalida dei dati non è stata impostata per la cella, questo metodo restituisce null.

// Log information about the data validation rule for cell A1.
var cell = SpreadsheetApp.getActive().getRange('A1');
var rule = cell.getDataValidation();
if (rule != null) {
  var criteria = rule.getCriteriaType();
  var args = rule.getCriteriaValues();
  Logger.log('The data validation rule is %s %s', criteria, args);
} else {
  Logger.log('The cell does not have a data validation rule.')
}

Ritorni

DataValidation: la regola di convalida dei dati per la cella superiore sinistra dell'intervallo.

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

`getDataValidations()`

Restituisce le regole di convalida dei dati per tutte le celle dell'intervallo. Se la convalida dei dati non è stata impostata per una determinata cella, questo metodo restituisce null per la posizione della cella nell'array.

// Change existing data validation rules that require a date in 2013 to require a date in 2014.
var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
var newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
var rules = range.getDataValidations();

for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    var rule = rules[i][j];

    if (rule != null) {
      var criteria = rule.getCriteriaType();
      var args = rule.getCriteriaValues();

      if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN
          && args[0].getTime() == oldDates[0].getTime()
          && args[1].getTime() == oldDates[1].getTime()) {
        // Create a builder from the existing rule, then change the dates.
        rules[i][j] = rule.copy().withCriteria(criteria, newDates).build();
      }
    }
  }
}
range.setDataValidations(rules);

Ritorni

DataValidation[][]: un array bidimensionale di regole di convalida dei dati associate alle celle nell'intervallo.

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

`getDeveloperMetadata()`

Restituisce i metadati dello sviluppatore associati a questo intervallo.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets row 2 on Sheet1.
const range = sheet.getRange('2:2');

// Adds metadata to row 2.
range.addDeveloperMetadata('NAME', 'GOOGLE');

// Logs the metadata to console.
for (const metadata of range.getDeveloperMetadata()) {
  console.log(`${metadata.getKey()}: ${metadata.getValue()}`);
}

Ritorni

DeveloperMetadata[]: i metadati dello sviluppatore associati a questo intervallo.

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

`getDisplayValue()`

Restituisce il valore visualizzato della cella superiore sinistra dell'intervallo. Il valore è String. Il valore visualizzato tiene conto della formattazione di data, ora e valuta, inclusi i formati applicati automaticamente dalle impostazioni internazionali del foglio di lavoro. Le celle vuote restituiscono una stringa vuota.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its value to 'Test code.'
const cell = sheet.getRange('A30');
cell.setValue('Test code');

// Gets the value and logs it to the console.
console.log(cell.getDisplayValue());

Ritorni

String: il valore visualizzato in questa cella.

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

`getDisplayValues()`

Restituisce la griglia rettangolare di valori per questo intervallo.

Restituisce un array bidimensionale di valori visualizzati, indicizzati per riga e poi per colonna. I valori sono oggetti String. Il valore visualizzato tiene conto della formattazione di data, ora e valuta, inclusi i formati applicati automaticamente dalle impostazioni internazionali del foglio di lavoro. Le celle vuote sono rappresentate da una stringa vuota nell'array. Ricorda che, mentre l'indice di un intervallo inizia da 1, 1, l'array JavaScript viene indicizzato da [0][0].

// The code below gets the displayed values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

Ritorni

String[][]: array bidimensionale di valori.

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

`getFilter()`

Restituisce il filtro nel foglio a cui appartiene questo intervallo oppure null se non è presente alcun filtro nel foglio.

let ss = SpreadsheetApp.getActiveSheet();
let range = ss.getRange("A1:C20");
// Gets the existing filter on the sheet that the given range belongs to.
let filter = range.getFilter();

Ritorni

Filter: il filtro.

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

`getFontColorObject()`

Restituisce il colore del carattere della cella nell'angolo superiore sinistro dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColorObject().asRgbColor().asHexString());

Ritorni

Color: il colore del carattere della cella superiore sinistra dell'intervallo.

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

`getFontColorObjects()`

Restituisce i colori dei caratteri delle celle dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColorObjects();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j].asRgbColor().asHexString());
  }
}

Ritorni

Color[][]: array bidimensionale di colori dei caratteri associati alle celle dell'intervallo.

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

`getFontFamilies()`

Restituisce le famiglie di caratteri delle celle dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontFamilies();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Ritorni

String[][]: array bidimensionale di famiglie di caratteri associate alle celle dell'intervallo.

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

`getFontFamily()`

Restituisce la famiglia di caratteri della cella nell'angolo superiore sinistro dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontFamily());

Ritorni

String: la famiglia di caratteri della cella.

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

`getFontLine()`

Restituisce lo stile della riga della cella nell'angolo in alto a sinistra dell'intervallo ('underline', 'line-through' o 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontLine());

Ritorni

String: riga del carattere.

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

`getFontLines()`

Restituisce lo stile della linea delle celle nell'intervallo ('underline', 'line-through' o 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontLines();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Ritorni

String[][]: array bidimensionale di linee di carattere associate alle celle dell'intervallo.

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

`getFontSize()`

Restituisce la dimensione del carattere in punti della cella nell'angolo superiore sinistro dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontSize());

Ritorni

Integer: dimensione del carattere in punti.

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

`getFontSizes()`

Restituisce le dimensioni dei caratteri delle celle dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontSizes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Ritorni

Integer[][]: array bidimensionale di dimensioni dei caratteri del testo associato alle celle dell'intervallo.

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

`getFontStyle()`

Restituisce lo stile del carattere ('italic' o 'normal') della cella nell'angolo in alto a sinistra dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontStyle());

Ritorni

String: lo stile del carattere del testo nella cella.

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

`getFontStyles()`

Restituisce gli stili di carattere delle celle dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontStyles();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Ritorni

String[][]: array bidimensionale di stili di carattere del testo associato alle celle nell'intervallo.

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

`getFontWeight()`

Restituisce lo spessore del carattere (normale/grassetto) della cella nell'angolo superiore sinistro dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontWeight());

Ritorni

String: lo spessore del carattere del testo nella cella.

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

`getFontWeights()`

Restituisce lo spessore del carattere delle celle dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontWeights();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Ritorni

String[][]: array bidimensionale di spessori carattere del testo associato alle celle dell'intervallo.

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

`getFormula()`

Restituisce la formula (notazione A1) per la cella in alto a sinistra dell'intervallo o una stringa vuota se la cella è vuota o non contiene una formula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This assumes you have a function in B5 that sums up
// B2:B4
var range = sheet.getRange("B5");

// Logs the calculated value and the formula
Logger.log("Calculated value: %s Formula: %s",
           range.getValue(),
           range.getFormula());

Ritorni

String: la formula della cella.

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

`getFormulaR1C1()`

Restituisce la formula (notazione R1C1) per una data cella o null se nessuna.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5");
var formula = range.getFormulaR1C1();
Logger.log(formula);

Ritorni

String: la formula nella notazione R1C1.

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

`getFormulas()`

Restituisce le formule (notazione A1) per le celle dell'intervallo. Le voci nell'array 2D sono stringhe vuote per le celle senza formula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulas();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Ritorni

String[][]: matrice bidimensionale di formule in formato stringa.

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

`getFormulasR1C1()`

Restituisce le formule (notazione R1C1) per le celle dell'intervallo. Le voci nell'array 2D sono null per le celle senza formula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formulas = range.getFormulasR1C1();
for (var i in formulas) {
  for (var j in formulas[i]) {
    Logger.log(formulas[i][j]);
  }
}

Ritorni

String[][]: una matrice bidimensionale di formule in notazione R1C1.

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

`getGridId()`

Restituisce l'ID griglia del foglio principale dell'intervallo. Gli ID sono valori interi non negativi casuali.

// Log the grid ID of the first sheet (by tab position) in the spreadsheet.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getGridId());

Ritorni

Integer: l'ID griglia del foglio principale.

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

`getHeight()`

Restituisce l'altezza dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// logs 3.0
Logger.log(range.getHeight());

Ritorni

Integer: l'altezza dell'intervallo.

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

`getHorizontalAlignment()`

Restituisce l'allineamento orizzontale del testo (sinistra/centro/destra) della cella nell'angolo in alto a sinistra dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getHorizontalAlignment());

Ritorni

String: allineamento orizzontale del testo nella cella.

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

`getHorizontalAlignments()`

Restituisce gli allineamenti orizzontali delle celle dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getHorizontalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Ritorni

String[][]: un array bidimensionale di allineamenti orizzontali di testo associati alle celle nell'intervallo.

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

`getLastColumn()`

Restituisce la posizione finale della colonna.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastColumn());

Ritorni

Integer: posizione della colonna finale dell'intervallo 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

`getLastRow()`

Restituisce la posizione della riga finale.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D4");
// Logs "4.0"
Logger.log(range.getLastRow());

Ritorni

Integer: posizione della riga finale dell'intervallo 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

`getMergedRanges()`

Restituisce un array di oggetti Range che rappresenta le celle unite che si trovano completamente all'interno dell'intervallo corrente o che contengono almeno una cella nell'intervallo corrente.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

var mergedRanges = range.getMergedRanges();
for (var i = 0; i < mergedRanges.length; i++) {
  Logger.log(mergedRanges[i].getA1Notation());
  Logger.log(mergedRanges[i].getDisplayValue());
}

Ritorni

Range[]: un array di oggetti Range, che rappresenta le celle unite che si sovrappongono all'intervallo.

`getNextDataCell(direction)`

Partendo dalla cella della prima colonna e riga dell'intervallo, restituisce la cella successiva nella direzione data che corrisponde al bordo di un intervallo contiguo di celle contenenti dati al loro interno o alla cella sul bordo del foglio di lavoro in quella direzione. Equivale a digitare Ctrl+[arrow key] nell'editor.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("C3:E5");
// Logs "C1"
Logger.log(range.getNextDataCell(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: la cella sul bordo della regione di dati o la cella sul bordo del 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

`getNote()`

Restituisce la nota associata all'intervallo specificato.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getNote());

Ritorni

String: la nota associata alla cella specificata.

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

`getNotes()`

Restituisce le note associate alle celle dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getNotes();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Ritorni

String[][]: array bidimensionale di note associate alle celle dell'intervallo.

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

`getNumColumns()`

Restituisce il numero di colonne in questo intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumColumns());

Ritorni

Integer: il numero di colonne in questo intervallo.

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

`getNumRows()`

Restituisce il numero di righe in questo intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
Logger.log(range.getNumRows());

Ritorni

Integer: il numero di righe in questo intervallo.

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

`getNumberFormat()`

Visualizza la formattazione del numero o della data della cella in alto a sinistra dell'intervallo specificato. I pattern di formato restituiti sono descritti nella documentazione dell'API Fogli.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("C4");
Logger.log(cell.getNumberFormat());

Ritorni

String: il formato numerico della cella superiore sinistra dell'intervallo.

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

`getNumberFormats()`

Restituisce il formato numerico o data per le celle dell'intervallo. I pattern di formato restituiti sono descritti nella documentazione relativa all'API Fogli.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B5:C6");
var formats = range.getNumberFormats();
for (var i in formats) {
  for (var j in formats[i]) {
    Logger.log(formats[i][j]);
  }
}

Ritorni

String[][]: array bidimensionale di formati numerici.

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

`getRichTextValue()`

Restituisce il valore RTF per la cella superiore sinistra dell'intervallo o null se il valore della cella non è testo.

// Gets the Rich Text value of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var richText = range.getRichTextValue();
console.log(richText.getText());

Ritorni

RichTextValue: il valore RTF della cella superiore sinistra dell'intervallo o null se il valore della cella non è testo.

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

`getRichTextValues()`

Restituisce i valori RTF per le celle dell'intervallo.

// Gets the Rich Text values for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var values = range.getRichTextValues();

for (var i = 0; i < values.length; i++) {
  for (var j = 0; j < values[i].length; j++) {
    console.log(values[i][j].getText());
  }
}

Ritorni

RichTextValue[][]: array bidimensionale di valori RTF.

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

`getRow()`

Restituisce la posizione della riga per questo intervallo. Identico a getRowIndex().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRow());

Ritorni

Integer: la posizione della riga dell'intervallo.

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

`getRowIndex()`

Restituisce la posizione della riga per questo intervallo. Identico a getRow().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2");
Logger.log(range.getRowIndex());

Ritorni

Integer: la posizione della riga dell'intervallo.

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

Vedi anche

getRow()

`getSheet()`

Restituisce il foglio a cui appartiene questo intervallo.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the sheet that the range belongs to.
const rangeSheet = range.getSheet();

// Gets the sheet name and logs it to the console.
console.log(rangeSheet.getName());

Ritorni

Sheet: il foglio a cui appartiene questo intervallo.

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

`getTextDirection()`

Restituisce la direzione del testo della cella superiore sinistra dell'intervallo. Restituisce null se la direzione del testo della cella viene determinata con il rilevamento automatico.

// Get the text direction of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getTextDirection());

Ritorni

TextDirection: la direzione del testo della cella superiore sinistra nell'intervallo.

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

`getTextDirections()`

Restituisce le direzioni del testo per le celle dell'intervallo. Le voci nell'array 2D sono null per le celle che utilizzano il rilevamento automatico.

// Get the text directions for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var directions = range.getTextDirections();

for (var i = 0; i < directions.length; i++) {
  for (var j = 0; j < directions[i].length; j++) {
    Logger.log(directions[i][j]);
  }
}

Ritorni

TextDirection[][]: array bidimensionale di direzioni del testo.

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

`getTextRotation()`

Restituisce le impostazioni di rotazione del testo per la cella superiore sinistra dell'intervallo.

// Log the text rotation settings for a cell.
var sheet = SpreadsheetApp.getActiveSheet();

var cell = sheet.getRange("A1");
Logger.log(cell.getTextRotation());

Ritorni

TextRotation - Le impostazioni di rotazione del testo.

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

`getTextRotations()`

Restituisce le impostazioni di rotazione del testo per le celle dell'intervallo.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

var results = range.getTextRotations();

for (var i in results) {
  for (var j in results[i]) {
    var rotation = results[i][j];
    Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation);
  }
}

Ritorni

TextRotation[][]: array bidimensionale di rotazioni del testo associate alle celle nell'intervallo.

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

`getTextStyle()`

Restituisce lo stile di testo per la cella superiore sinistra dell'intervallo.

// Get the text style of cell D4.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("D4:F6");
var style = range.getTextStyle();
Logger.log(style);

Ritorni

TextStyle: lo stile di testo della cella superiore sinistra dell'intervallo.

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

`getTextStyles()`

Restituisce gli stili di testo per le celle dell'intervallo.

// Get the text styles for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var styles = range.getTextStyles();

for (var i = 0; i < styles.length; i++) {
  for (var j = 0; j < styles[i].length; j++) {
    Logger.log(styles[i][j]);
  }
}

Ritorni

TextStyle[][]: array bidimensionale di stili di testo.

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

`getValue()`

Restituisce il valore della cella in alto a sinistra nell'intervallo. Il valore può essere di tipo Number, Boolean, Date o String a seconda del valore della cella. Le celle vuote restituiscono una stringa vuota.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the value of the top-left cell in the range and logs it to the console.
console.log(range.getValue());

Ritorni

Object: il valore in questa cella.

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

`getValues()`

Restituisce la griglia rettangolare di valori per questo intervallo.

Restituisce un array bidimensionale di valori, indicizzati per riga e poi per colonna. I valori possono essere di tipo Number, Boolean, Date o String, a seconda del valore della cella. Le celle vuote sono rappresentate da una stringa vuota nell'array. Ricorda che, sebbene l'indice di un intervallo inizia da 1, 1, l'array JavaScript viene indicizzato da [0][0].

// The code below gets the values for the range C2:G8
// in the active spreadsheet.  Note that this is a JavaScript array.
var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);

Nelle app web, il valore Date non è un parametro valido. getValues() non riesce a restituire dati a un'app web se l'intervallo contiene una cella con un valore Date. Trasforma invece tutti i valori recuperati dal foglio in una primitiva JavaScript supportata come Number, Boolean o String.

Ritorni

Object[][]: array bidimensionale di valori.

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

`getVerticalAlignment()`

Restituisce l'allineamento verticale (superiore/medio/basso) della cella nell'angolo superiore sinistro dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getVerticalAlignment());

Ritorni

String: l'allineamento verticale del testo nella cella.

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

`getVerticalAlignments()`

Restituisce gli allineamenti verticali delle celle dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Ritorni

String[][]: un array bidimensionale di allineamenti verticali di testo associati alle celle nell'intervallo.

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

`getWidth()`

Restituisce la larghezza dell'intervallo nelle colonne.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Gets the width of the range in number of columns and logs it to the console.
console.log(range.getWidth());

Ritorni

Integer: il numero di colonne nell'intervallo.

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

`getWrap()`

Restituisce se il testo nella cella va a capo. Per una strategia di aggregazione più granulare, utilizza getWrapStrategy().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getWrap());

Ritorni

Boolean: indica se il testo nella cella va a capo.

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

`getWrapStrategies()`

Restituisce le strategie di testo a capo per le celle dell'intervallo.

// Get the text wrapping strategies for all cells in range B5:C6
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
var strategies = range.getWrapStrategies();

for (var i = 0; i < strategies.length; i++) {
  for (var j = 0; j < strategies[i].length; j++) {
    Logger.log(strategies[i][j]);
  }
}

Ritorni

WrapStrategy[][]: array bidimensionale di strategie di testo a capo.

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

`getWrapStrategy()`

Restituisce la strategia di testo a capo per la cella superiore sinistra dell'intervallo.

// Get the text wrapping strategy of cell B1.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B1:D4");
Logger.log(range.getWrapStrategy());

Ritorni

WrapStrategy: la strategia di ritorno a capo automatico della cella in alto a sinistra nell'intervallo.

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

`getWraps()`

Restituisce un valore che indica se il testo nelle celle deve andare a capo. Per una strategia di aggregazione più granulare, utilizza getWrapStrategies().

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getVerticalAlignments();

for (var i in results) {
  for (var j in results[i]) {
    var isWrapped = results[i][j];
    if (isWrapped) {
       Logger.log("Cell [%s, %s] has wrapped text", i, j);
    }
  }
}

Ritorni

Boolean[][]: un array bidimensionale di allineamenti verticali di testo associati alle celle nell'intervallo.

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

`insertCells(shiftDimension)`

Inserisce celle vuote in questo intervallo. Le nuove celle mantengono la formattazione presente nelle celle che occupavano in precedenza questo intervallo. I dati esistenti nel foglio lungo la dimensione fornita vengono spostati dall'intervallo inserito.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:D10");
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Parametri

Nome	Tipo	Descrizione
`shiftDimension`	`Dimension`	La dimensione in base alla quale spostare i dati esistenti.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`insertCheckboxes()`

Inserisce le caselle di controllo in ogni cella dell'intervallo, configurata con true per selezionata e false per deselezionata. Imposta il valore di tutte le celle dell'intervallo su false.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'.
range.insertCheckboxes();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`insertCheckboxes(checkedValue)`

Inserisce caselle di controllo in ogni cella dell'intervallo, configurata con un valore personalizzato per selezionata e la stringa vuota per deselezionata. Imposta il valore di ogni cella dell'intervallo sulla stringa vuota.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to
//  the empty string.
range.insertCheckboxes('yes');

Parametri

Nome	Tipo	Descrizione
`checkedValue`	`Object`	Il valore selezionato per la convalida dei dati della casella di controllo.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`insertCheckboxes(checkedValue, uncheckedValue)`

Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e non selezionati. Imposta il valore di ogni cella nell'intervallo sul valore personalizzato deselezionato.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'.
range.insertCheckboxes('yes', 'no');

Parametri

Nome	Tipo	Descrizione
`checkedValue`	`Object`	Il valore selezionato per la convalida dei dati della casella di controllo.
`uncheckedValue`	`Object`	Il valore deselezionato per la convalida dei dati della casella di controllo.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`isBlank()`

Restituisce true se l'intervallo è completamente vuoto.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.isBlank());

Ritorni

Boolean: true se l'intervallo è vuoto; false in caso contrario.

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

`isChecked()`

Indica se la casella di controllo di tutte le celle dell'intervallo è "selezionata". Restituisce null se alcune celle sono selezionate e le altre deselezionate o se alcune celle non hanno una casella di controllo di convalida dei dati.

var range = SpreadsheetApp.getActive().getRange('A1:A3');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:A3.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Sets the value of isRange1Checked as true as it contains the checked value.
var isRange1Checked = range1.isChecked();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('no');
// Sets the value of isRange2Checked as false as it contains the unchecked value.
var isRange2Checked = range2.isChecked();

var range3 = SpreadsheetApp.getActive().getRange('A3');
range3.setValue('random');
// Sets the value of isRange3Checked as null, as it contains an invalid checkbox value.
var isRange3Checked = range3.isChecked();

Ritorni

Boolean: true, se tutte le celle dell'intervallo sono selezionate, false se tutte le celle dell'intervallo sono deselezionate o null se alcune delle celle sono deselezionate o non presentano la casella di controllo di convalida dei dati.

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

`isEndColumnBounded()`

Determina se la fine dell'intervallo è associata a una determinata colonna. Ad esempio, per gli intervalli A1:B10 o B:B, associati a colonne alla fine dell'intervallo, questo metodo restituisce true. Per gli intervalli 3:7 o A1:5, associati solo a determinate righe alla fine dell'intervallo, questo metodo restituisce false.

 // Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular column and logs it to the
// console.
console.log(range.isEndColumnBounded());

Ritorni

Boolean: true se la fine dell'intervallo è associata a una determinata colonna; in caso contrario false.

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

`isEndRowBounded()`

Determina se la fine dell'intervallo è associata a una determinata riga. Ad esempio, per gli intervalli A1:B10 o 3:7, che sono associati alle righe alla fine dell'intervallo, questo metodo restituisce true; per gli intervalli B:B o A1:C, associati solo a colonne specifiche alla fine dell'intervallo, questo metodo restituisce false.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the end of the range is bound to a particular row and logs it to the console.
console.log(range.isEndRowBounded());

Ritorni

Boolean: true se la fine dell'intervallo è associata a una determinata riga; in caso contrario false.

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

`isPartOfMerge()`

Restituisce true se le celle nell'intervallo corrente si sovrappongono a eventuali celle unite.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("A1:B3");

// True if any of the cells in A1:B3 is included in a merge.
var isPartOfMerge = range.isPartOfMerge();

Ritorni

Boolean: true se l'intervallo si sovrappone a qualsiasi cella unita; in caso contrario, restituisce false.

`isStartColumnBounded()`

Determina se l'inizio dell'intervallo è associato a una determinata colonna. Ad esempio, per gli intervalli A1:B10 o B:B, che sono associati alle colonne all'inizio dell'intervallo, questo metodo restituisce true; per l'intervallo 3:7, associato solo a una riga all'inizio dell'intervallo, questo metodo restituisce false.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular column and logs it to the
// console.
console.log(range.isStartColumnBounded());

Ritorni

Boolean: true se l'inizio dell'intervallo è associato a una determinata colonna; in caso contrario false.

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

`isStartRowBounded()`

Determina se l'inizio dell'intervallo è associato a una determinata riga. Ad esempio, per gli intervalli A1:B10 o 3:7, associati alle righe all'inizio dell'intervallo, questo metodo restituisce true. Per l'intervallo B:B, associato solo a una determinata colonna all'inizio dell'intervallo, questo metodo restituisce false.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets the range A1:D10 on Sheet1.
const range = sheet.getRange('A1:D10');

// Determines if the start of the range is bound to a particular row and logs it to the
// console.
console.log(range.isStartRowBounded());

Ritorni

Boolean: true se l'inizio dell'intervallo è associato a una determinata riga; in caso contrario false.

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

`merge()`

Unisce le celle dell'intervallo in un unico blocco.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below 2-dimensionally merges the cells in A1 to B3
sheet.getRange('A1:B3').merge();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`mergeAcross()`

Unisci le celle dell'intervallo nelle colonne dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The code below merges cells C5:E5 into one cell
var range1 = sheet.getRange("C5:E5");
range1.mergeAcross();

// The code below creates 2 horizontal cells, F5:H5 and F6:H6
var range2 = sheet.getRange("F5:H6");
range2.mergeAcross();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`mergeVertically()`

Unisce insieme le celle dell'intervallo.

var sheet = SpreadsheetApp.getActiveSheet();

// The code below vertically merges the cells in A1 to A10
sheet.getRange('A1:A10').mergeVertically();

// The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10
sheet.getRange('B1:D10').mergeVertically();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`moveTo(target)`

Taglia e incolla (sia il formato che i valori) da questo intervallo all'intervallo target.

// The code below moves the first 5 columns over to the 6th column
var sheet = SpreadsheetApp.getActiveSheet()
sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));

Parametri

Nome	Tipo	Descrizione
`target`	`Range`	Un intervallo di destinazione in cui copiare questo intervallo; è pertinente solo la posizione della cella in alto a sinistra.

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

`offset(rowOffset, columnOffset)`

Restituisce un nuovo intervallo che viene spostato da questo intervallo in base al numero specificato di righe e colonne (che può essere negativo). Il nuovo intervallo ha le stesse dimensioni dell'intervallo originale.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2
var newCell = cell.offset(1, 1);

Parametri

Nome	Tipo	Descrizione
`rowOffset`	`Integer`	Il numero di righe in basso rispetto alla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le righe verso l'alto dalla cella in alto a sinistra dell'intervallo.
`columnOffset`	`Integer`	Il numero di colonne a destra dalla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le colonne a sinistra dalla cella in alto a sinistra dell'intervallo.

Ritorni

Range: questo intervallo, per il concatenamento.

`offset(rowOffset, columnOffset, numRows)`

Restituisce un nuovo intervallo relativo all'intervallo corrente il cui punto in alto a sinistra è spostato rispetto all'intervallo corrente dalle righe e colonne specificate e con l'altezza specificata nelle celle.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:B3
var newRange = cell.offset(1, 1, 2);

Parametri

Nome	Tipo	Descrizione
`rowOffset`	`Integer`	Il numero di righe in basso rispetto alla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le righe verso l'alto dalla cella in alto a sinistra dell'intervallo.
`columnOffset`	`Integer`	Il numero di colonne a destra dalla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le colonne a sinistra dalla cella in alto a sinistra dell'intervallo.
`numRows`	`Integer`	L'altezza nelle righe del nuovo intervallo.

Ritorni

Range: questo intervallo, per il concatenamento.

`offset(rowOffset, columnOffset, numRows, numColumns)`

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("A1");

// newCell references B2:C3
var newRange = cell.offset(1, 1, 2, 2);

Parametri

Nome	Tipo	Descrizione
`rowOffset`	`Integer`	Il numero di righe in basso rispetto alla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le righe verso l'alto dalla cella in alto a sinistra dell'intervallo.
`columnOffset`	`Integer`	Il numero di colonne a destra dalla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le colonne a sinistra dalla cella in alto a sinistra dell'intervallo.
`numRows`	`Integer`	L'altezza nelle righe del nuovo intervallo.
`numColumns`	`Integer`	La larghezza in colonne del nuovo intervallo.

Ritorni

Range: questo intervallo, per il concatenamento.

`protect()`

Crea un oggetto in grado di proteggere l'intervallo dalla modifica, se non dagli utenti che dispongono dell'autorizzazione. Finché lo script non modifica effettivamente l'elenco di editor per l'intervallo (chiamando Protection.removeEditor(emailAddress), Protection.removeEditor(user), Protection.removeEditors(emailAddresses), Protection.addEditor(emailAddress), Protection.addEditor(user), Protection.addEditors(emailAddresses) o impostando un nuovo valore per Protection.setDomainEdit(editable)), le autorizzazioni rispecchiano quelle del foglio di lavoro stesso, il che significa di fatto che l'intervallo non è protetto. Se l'intervallo è già protetto, questo metodo crea un nuovo intervallo protetto che si sovrappone a quello esistente. Se una cella è protetta da più intervalli protetti e uno di questi impedisce a un determinato utente di modificarla, l'utente non potrà modificare la cella.

// Protect range A1:B10, then remove all other users from the list of editors.
var ss = SpreadsheetApp.getActive();
var range = ss.getRange('A1:B10');
var protection = range.protect().setDescription('Sample protected range');

// Ensure the current user is an editor before removing others. Otherwise, if the user's edit
// permission comes from a group, the script throws an exception upon removing the group.
var me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Ritorni

Protection: oggetto che rappresenta le impostazioni di protezione.

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

`randomize()`

Randomizza l'ordine delle righe nell'intervallo specificato.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Randomizes the range
range.randomize();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`removeCheckboxes()`

Rimuove tutte le caselle di controllo dall'intervallo. Cancella la convalida dei dati di ogni cella e cancella anche il relativo valore se la cella contiene il valore selezionato o deselezionato.

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

var range1 = SpreadsheetApp.getActive().getRange('A1');
range1.setValue('yes');
// Removes the checkbox data validation in cell A1 and clears its value.
range1.removeCheckboxes();

var range2 = SpreadsheetApp.getActive().getRange('A2');
range2.setValue('random');
// Removes the checkbox data validation in cell A2 but does not clear its value.
range2.removeCheckboxes();

Ritorni

Range: questo intervallo, per il concatenamento.

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

`removeDuplicates()`

Rimuove le righe in questo intervallo che contengono valori che sono duplicati di valori in qualsiasi riga precedente. Le righe con valori identici ma con lettere maiuscole, formattazione o formule diverse vengono considerate duplicate. Questo metodo rimuove anche le righe duplicate nascoste (ad esempio, a causa di un filtro). I contenuti al di fuori di questo intervallo non vengono rimossi.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove duplicate rows in the range.
range.removeDuplicates();

Ritorni

Range: l'intervallo risultante dopo la rimozione dei duplicati. La dimensione dell'intervallo viene ridotta di una riga per ogni riga rimossa.

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

`removeDuplicates(columnsToCompare)`

Rimuove le righe in questo intervallo che contengono valori nelle colonne specificate che sono duplicati di valori di qualsiasi riga precedente. Le righe con valori identici ma con lettere maiuscole, formattazione o formule diverse vengono considerate duplicate. Questo metodo rimuove anche le righe duplicate nascoste (ad esempio a causa di un filtro). I contenuti al di fuori di questo intervallo non vengono rimossi.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B1:D7");

// Remove rows which have duplicate values in column B.
range.removeDuplicates([2]);

// Remove rows which have duplicate values in both columns B and D.
range.removeDuplicates([2,4]);

Parametri

Nome	Tipo	Descrizione
`columnsToCompare`	`Integer[]`	Le colonne da analizzare per individuare i valori duplicati. Se non vengono fornite colonne, tutte le colonne vengono analizzate per rilevare eventuali duplicati.

Ritorni

Range: l'intervallo risultante dopo la rimozione dei duplicati. La dimensione dell'intervallo viene ridotta di una riga per ogni riga rimossa.

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

`setBackground(color)`

Imposta il colore di sfondo di tutte le celle dell'intervallo nella notazione CSS (come '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var range = sheet.getRange("B2:D5");
range.setBackground("red");

Parametri

Nome	Tipo	Descrizione
`color`	`String`	Un codice colore in notazione CSS (come `'#ffffff'` o `'white'`); un valore `null` reimposta il colore.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setBackgroundObject(color)`

Imposta il colore di sfondo di tutte le celle dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var bgColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();

var range = sheet.getRange("B2:D5");
range.setBackgroundObject(bgColor);

Parametri

Nome	Tipo	Descrizione
`color`	`Color`	Il colore di sfondo da impostare; il valore `null` reimposta il colore dello sfondo.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setBackgroundObjects(color)`

Imposta una griglia rettangolare di colori di sfondo (devono corrispondere alle dimensioni di questo intervallo).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setBackgroundObjects(colors);

Parametri

Nome	Tipo	Descrizione
`color`	`Color[][]`	Un array bidimensionale di colori; i valori `null` reimpostano il colore.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setBackgroundRGB(red, green, blue)`

Imposta lo sfondo sul colore specificato utilizzando valori RGB (numeri interi compresi tra 0 e 255 inclusi).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");

// Sets the background to white
cell.setBackgroundRGB(255, 255, 255);

// Sets the background to red
cell.setBackgroundRGB(255, 0, 0);

Parametri

Nome	Tipo	Descrizione
`red`	`Integer`	Il valore rosso in notazione RGB.
`green`	`Integer`	Il valore verde in notazione RGB.
`blue`	`Integer`	Il valore blu in notazione RGB.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setBackgrounds(color)`

Imposta una griglia rettangolare di colori di sfondo (devono corrispondere alle dimensioni di questo intervallo). I colori sono in notazione CSS (come '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setBackgrounds(colors);

Parametri

Nome	Tipo	Descrizione
`color`	`String[][]`	Un array bidimensionale di colori in notazione CSS (come `'#ffffff'` o `'white'`); i valori `null` reimpostano il colore.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setBorder(top, left, bottom, right, vertical, horizontal)`

Imposta la proprietà del bordo. I valori validi sono true (on), false (off) e null (nessuna modifica).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
cell.setBorder(true, null, true, null, false, false);

Parametri

Nome	Tipo	Descrizione
`top`	`Boolean`	`true` per il bordo, `false` per nessuno e `null` per nessuna modifica.
`left`	`Boolean`	`true` per il bordo, `false` per nessuno e `null` per nessuna modifica.
`bottom`	`Boolean`	`true` per il bordo, `false` per nessuno e `null` per nessuna modifica.
`right`	`Boolean`	`true` per il bordo, `false` per nessuno e `null` per nessuna modifica.
`vertical`	`Boolean`	`true` per i bordi verticali interni, `false` per nessuno, `null` per nessuna modifica.
`horizontal`	`Boolean`	`true` per i bordi orizzontali interni, `false` per nessuno, `null` per nessuna modifica.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`

Imposta la proprietà del bordo con colore e/o stile. I valori validi sono true (on), false (off) e null (nessuna modifica). Per il colore, utilizza Colore nella notazione CSS (ad esempio '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Sets borders on the top and bottom, but leaves the left and right unchanged
// Also sets the color to "red", and the border to "DASHED".
cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);

Parametri

Nome	Tipo	Descrizione
`top`	`Boolean`	`true` per il bordo, `false` per nessuno e `null` per nessuna modifica.
`left`	`Boolean`	`true` per il bordo, `false` per nessuno e `null` per nessuna modifica.
`bottom`	`Boolean`	`true` per il bordo, `false` per nessuno e `null` per nessuna modifica.
`right`	`Boolean`	`true` per il bordo, `false` per nessuno e `null` per nessuna modifica.
`vertical`	`Boolean`	`true` per i bordi verticali interni, `false` per nessuno, `null` per nessuna modifica.
`horizontal`	`Boolean`	`true` per i bordi orizzontali interni, `false` per nessuno, `null` per nessuna modifica.
`color`	`String`	Un colore nella notazione CSS (ad esempio `'#ffffff'` o `'white'`), `null` per il colore predefinito (nero).
`style`	`BorderStyle`	Uno stile per i bordi, `null` per lo stile predefinito (solido).

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setDataValidation(rule)`

Imposta una regola di convalida dei dati per tutte le celle dell'intervallo.

// Set the data validation rule for cell A1 to require a value from B1:B10.
var cell = SpreadsheetApp.getActive().getRange('A1');
var range = SpreadsheetApp.getActive().getRange('B1:B10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build();
cell.setDataValidation(rule);

Parametri

Nome	Tipo	Descrizione
`rule`	`DataValidation`	La regola di convalida dei dati da impostare o `null` per rimuovere la convalida dei dati.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setDataValidations(rules)`

Imposta le regole di convalida dei dati per tutte le celle dell'intervallo. Questo metodo prende un array bidimensionale di convalide dei dati, indicizzate per riga e poi per colonna. Le dimensioni dell'array devono corrispondere alle dimensioni dell'intervallo.

// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10.
var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
var rules = destinationRange.getDataValidations();
for (var i = 0; i < rules.length; i++) {
  for (var j = 0; j < rules[i].length; j++) {
    rules[i][j] = rule;
  }
}
destinationRange.setDataValidations(rules);

Parametri

Nome	Tipo	Descrizione
`rules`	`DataValidation[][]`	Un array bidimensionale di regole di convalida dei dati da impostare; i valori `null` rimuovono la convalida dei dati.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontColor(color)`

Imposta il colore del carattere nella notazione CSS (ad esempio '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontColor("red");

Parametri

Nome	Tipo	Descrizione
`color`	`String`	Il colore del carattere nella notazione CSS (come `'#ffffff'` o `'white'`); un valore `null` reimposta il colore.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontColorObject(color)`

Imposta il colore del carattere dell'intervallo specificato.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();

var cell = sheet.getRange("B2");
cell.setFontColor(color);

Parametri

Nome	Tipo	Descrizione
`color`	`Color`	Il colore del carattere da impostare; un valore `null` reimposta il colore.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontColorObjects(colors)`

Consente di impostare una griglia rettangolare di colori dei caratteri (devono corrispondere alle dimensioni di questo intervallo).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colorAccent1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var colorAccent2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var colorAccent3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var colorAccent4 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4)
    .build();

var colors = [
  [colorAccent1, colorAccent2],
  [colorAccent3, colorAccent4]
];

var cell = sheet.getRange("B5:C6");
cell.setFontColorObjects(colors);

Parametri

Nome	Tipo	Descrizione
`colors`	`Color[][]`	Un array bidimensionale di colori; i valori `null` reimpostano il colore del carattere.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontColors(colors)`

Consente di impostare una griglia rettangolare di colori dei caratteri (devono corrispondere alle dimensioni di questo intervallo). I colori sono in notazione CSS (come '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var colors = [
  ["red", "white", "blue"],
  ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents
];

var cell = sheet.getRange("B5:D6");
cell.setFontColors(colors);

Parametri

Nome	Tipo	Descrizione
`colors`	`Object[][]`	Un array bidimensionale di colori in notazione CSS (come `'#ffffff'` o `'white'`); i valori `null` reimpostano il colore.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontFamilies(fontFamilies)`

Imposta una griglia rettangolare di famiglie di caratteri (le dimensioni devono corrispondere a questo intervallo). Esempi di famiglie di caratteri sono "Fondato su Google" o "H categoria".

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var fonts = [
  ["Arial", "Helvetica", "Verdana"],
  ["Courier New", "Arial", "Helvetica]
];

var cell = sheet.getRange("B2:D3");
cell.setFontFamilies(fonts);

Parametri

Nome	Tipo	Descrizione
`fontFamilies`	`Object[][]`	Un array bidimensionale di famiglie di caratteri; i valori `null` reimpostano la famiglia di caratteri.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontFamily(fontFamily)`

Imposta la famiglia di caratteri, ad esempio "Arial" o "Helvetica".

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontFamily("Helvetica");

Parametri

Nome	Tipo	Descrizione
`fontFamily`	`String`	La famiglia di caratteri da impostare; un valore `null` reimposta la famiglia di caratteri.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontLine(fontLine)`

Imposta lo stile della linea del carattere per l'intervallo specificato ('underline', 'line-through' o 'none').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontLine("line-through");

Parametri

Nome	Tipo	Descrizione
`fontLine`	`String`	Lo stile della linea del carattere, `'underline'`, `'line-through'` o `'none'`; un valore `null` reimposta lo stile della linea del carattere.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontLines(fontLines)`

Imposta una griglia rettangolare di stili di linea (devono corrispondere alle dimensioni di questo intervallo).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontLines = [
  ["underline", "line-through", "none"]
];

var range = sheet.getRange("B2:D2");
range.setFontLines(fontLines);

Parametri

Nome	Tipo	Descrizione
`fontLines`	`Object[][]`	Un array bidimensionale di stili di linee dei caratteri (`'underline'`, `'line-through'` o `'none'`); i valori `null` reimpostano lo stile della linea del carattere.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontSize(size)`

Imposta la dimensione del carattere, dove la dimensione corrisponde alla dimensione in punti da utilizzare.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontSize(20);

Parametri

Nome	Tipo	Descrizione
`size`	`Integer`	La dimensione del carattere in punti.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontSizes(sizes)`

Imposta una griglia rettangolare di dimensioni carattere (devono corrispondere alle dimensioni di questo intervallo). Le dimensioni sono espresse in punti.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontSizes = [
  [16, 20, 24]
];

var range = sheet.getRange("B2:D2");
range.setFontSizes(fontSizes);

Parametri

Nome	Tipo	Descrizione
`sizes`	`Object[][]`	Un array bidimensionale di dimensioni.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontStyle(fontStyle)`

Imposta lo stile del carattere per l'intervallo specificato ('italic' o 'normal').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontStyle("italic");

Parametri

Nome	Tipo	Descrizione
`fontStyle`	`String`	Lo stile del carattere, `'italic'` o `'normal'`; un valore `null` reimposta lo stile del carattere.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontStyles(fontStyles)`

Imposta una griglia rettangolare di stili dei caratteri (devono corrispondere alle dimensioni di questo intervallo).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  ["italic", "normal"]
];

var range = sheet.getRange("B2:C2");
range.setFontStyles(fontStyles);

Parametri

Nome	Tipo	Descrizione
`fontStyles`	`Object[][]`	Un array bidimensionale di stili dei caratteri, `'italic'` o `'normal'`; i valori `null` reimpostano lo stile del carattere.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontWeight(fontWeight)`

Imposta lo spessore del carattere per l'intervallo specificato (normale/grassetto).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setFontWeight("bold");

Parametri

Nome	Tipo	Descrizione
`fontWeight`	`String`	Lo spessore del carattere, `'bold'` o `'normal'`; un valore `null` reimposta lo spessore del carattere.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFontWeights(fontWeights)`

Imposta una griglia rettangolare di spessori dei caratteri (devono corrispondere alle dimensioni di questo intervallo). Un esempio di spessore del carattere è il "grassetto".

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var fontStyles = [
  [ "bold", "bold", "normal" ]
];

var range = sheet.getRange("B2:D2");
range.setFontWeights(fontStyles);

Parametri

Nome	Tipo	Descrizione
`fontWeights`	`Object[][]`	Un array bidimensionale di spessori carattere, `'bold'` o `'normal'`; i valori `null` reimpostano lo spessore del carattere.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFormula(formula)`

Aggiorna la formula per questo intervallo. La formula specificata deve essere in notazione A1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
cell.setFormula("=SUM(B3:B4)");

Parametri

Nome	Tipo	Descrizione
`formula`	`String`	Una stringa che rappresenta la formula da impostare per la cella.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFormulaR1C1(formula)`

Aggiorna la formula per questo intervallo. La formula data deve essere in notazione R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B5");
// This sets the formula to be the sum of the 3 rows above B5
cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");

Parametri

Nome	Tipo	Descrizione
`formula`	`String`	Una formula stringa.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFormulas(formulas)`

Imposta una griglia rettangolare di formule (devono corrispondere alle dimensioni di questo intervallo). Le formule date devono essere in notazione A1. Questo metodo prende una matrice bidimensionale di formule, indicizzate per riga e poi per colonna. Le dimensioni dell'array devono corrispondere alle dimensioni dell'intervallo.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This sets the formulas to be a row of sums, followed by a row of averages right below.
// The size of the two-dimensional array must match the size of the range.
var formulas = [
  ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"],
  ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"]
];

var cell = sheet.getRange("B5:D6");
cell.setFormulas(formulas);

Parametri

Nome	Tipo	Descrizione
`formulas`	`String[][]`	Una matrice stringa bidimensionale di formule.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setFormulasR1C1(formulas)`

Imposta una griglia rettangolare di formule (devono corrispondere alle dimensioni di questo intervallo). Le formule date devono essere in notazione R1C1.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// This creates formulas for a row of sums, followed by a row of averages.
var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])";
var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])";

// The size of the two-dimensional array must match the size of the range.
var formulas = [
  [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove],
  [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove]
];

var cell = sheet.getRange("B5:D6");
// This sets the formula to be the sum of the 3 rows above B5.
cell.setFormulasR1C1(formulas);

Parametri

Nome	Tipo	Descrizione
`formulas`	`String[][]`	Una matrice bidimensionale di formule in formato R1C1.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setHorizontalAlignment(alignment)`

Imposta l'allineamento orizzontale (da sinistra a destra) per l'intervallo specificato (sinistra/centro/destra).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setHorizontalAlignment("center");

Parametri

Nome	Tipo	Descrizione
`alignment`	`String`	L'allineamento, `'left'`, `'center'` o `'normal'`; un valore `null` reimposta l'allineamento.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setHorizontalAlignments(alignments)`

Imposta una griglia rettangolare di allineamenti orizzontali. Vedi setHorizontalAlignment(alignment)

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var horizontalAlignments = [
  [ "left", "right", "center" ]
];

var range = sheet.getRange("B2:D2");
range.setHorizontalAlignments(horizontalAlignments);

Parametri

Nome	Tipo	Descrizione
`alignments`	`Object[][]`	Un array bidimensionale di allineamenti, `'left'`, `'center'` o `'normal'`; un valore `null` reimposta l'allineamento.

Ritorni

Range: questo intervallo, per il concatenamento.

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

Vedi anche

setHorizontalAlignment(alignment)

`setNote(note)`

Imposta la nota sul valore specificato.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setNote("This is a note");

Parametri

Nome	Tipo	Descrizione
`note`	`String`	Il valore della nota da impostare per l'intervallo; un valore `null` rimuove la nota.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setNotes(notes)`

Imposta una griglia rettangolare di note (devono corrispondere alle dimensioni di questo intervallo).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var notes = [
  ["it goes", "like this", "the fourth, the fifth"],
  ["the minor fall", "and the", "major lift"]
];

var cell = sheet.getRange("B2:D3");
cell.setNotes(notes)

Parametri

Nome	Tipo	Descrizione
`notes`	`Object[][]`	Un array bidimensionale di note; i valori `null` rimuovono la nota.

Ritorni

Range: questo intervallo, per il concatenamento.

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

Vedi anche

setNote(note)

`setNumberFormat(numberFormat)`

Imposta il formato numerico o data sulla stringa di formattazione specificata. I pattern di formato accettati sono descritti nella documentazione relativa all'API Fogli.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
// Always show 3 decimal points
cell.setNumberFormat("0.000");

Parametri

Nome	Tipo	Descrizione
`numberFormat`	`String`	Una stringa di formato numerico.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setNumberFormats(numberFormats)`

Imposta una griglia rettangolare di formati numerici o di data (devono corrispondere alle dimensioni di questo intervallo). I valori sono stringhe di formato di pattern, come descritto nella documentazione relativa all'API Fogli.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var formats = [
  [ "0.000", "0,000,000", "$0.00" ]
];

var range = sheet.getRange("B2:D2");
range.setNumberFormats(formats);

Parametri

Nome	Tipo	Descrizione
`numberFormats`	`Object[][]`	Un array bidimensionale di formati numerici.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setRichTextValue(value)`

Imposta il valore RTF per le celle dell'intervallo.

// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var richText = SpreadsheetApp.newRichTextValue()
    .setText("Hello world")
    .setTextStyle(0, 5, bold)
    .build();
range.setRichTextValue(richText);

Parametri

Nome	Tipo	Descrizione
`value`	`RichTextValue`	Il valore RTF desiderato.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setRichTextValues(values)`

Imposta una griglia rettangolare di valori RTF.

// Sets the cells in range A1:A2 to have Rich Text values.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:A2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var italic = SpreadsheetApp.newTextStyle()
    .setItalic(true)
    .build();
var richTextA1 = SpreadsheetApp.newRichTextValue()
    .setText("This cell is bold")
    .setTextStyle(bold)
    .build();
var richTextA2 = SpreadsheetApp.newRichTextValue()
    .setText("bold words, italic words")
    .setTextStyle(0, 11, bold)
    .setTextStyle(12, 24, italic)
    .build();
range.setRichTextValues([[richTextA1], [richTextA2]]);

Parametri

Nome	Tipo	Descrizione
`values`	`RichTextValue[][]`	I valori RTF desiderati.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setShowHyperlink(showHyperlink)`

Consente di impostare se l'intervallo deve mostrare o meno i link ipertestuali.

// Opens the spreadsheet file by its URL. If you created your script from within a
// Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead.
// TODO(developer): Replace the URL with your own.
const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit');

// Gets Sheet1 by its name.
const sheet = ss.getSheetByName('Sheet1');

// Gets cell A30 and sets its hyperlink value.
const range = sheet.getRange('A30');
range.setValue('https://www.example.com');

// Sets cell A30 to show hyperlinks.
range.setShowHyperlink(true);

Parametri

Nome	Tipo	Descrizione
`showHyperlink`	`Boolean`	Indica se mostrare o meno il link ipertestuale.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setTextDirection(direction)`

Imposta la direzione del testo per le celle nell'intervallo. Se una direzione specificata è null, la direzione viene dedotta e poi impostata.

// Sets right-to-left text direction for the range.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B5:C6");
range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parametri

Nome	Tipo	Descrizione
`direction`	`TextDirection`	La direzione del testo desiderata; se `null` la direzione viene dedotta prima dell'impostazione.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setTextDirections(directions)`

Imposta una griglia rettangolare di direzioni del testo. Se una direzione specificata è null, la direzione viene dedotta e quindi impostata.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextDirections());

Parametri

Nome	Tipo	Descrizione
`directions`	`TextDirection[][]`	Le direzioni del testo desiderate. Se una direzione specificata è `null`, viene dedotta prima dell'impostazione.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setTextRotation(degrees)`

Consente di impostare le impostazioni di rotazione del testo per le celle dell'intervallo. L'input corrisponde all'angolo tra l'orientamento standard del testo e l'orientamento desiderato. Un input pari a zero indica che il testo è impostato sull'orientamento standard.

Per la direzione del testo da sinistra a destra, gli angoli positivi sono in senso antiorario, mentre da destra a sinistra sono in senso orario.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setTextRotation(45);

Parametri

Nome	Tipo	Descrizione
`degrees`	`Integer`	L'angolo desiderato tra l'orientamento standard e quello desiderato. Per il testo da sinistra a destra, gli angoli positivi sono orientati in senso antiorario.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setTextRotation(rotation)`

Consente di impostare le impostazioni di rotazione del testo per le celle dell'intervallo.

// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1.
var sheet = SpreadsheetApp.getActiveSheet();

var rotation = sheet.getRange("A1").getTextRotation();

sheet.getRange("B2:D4").setTextRotation(rotation);

Parametri

Nome	Tipo	Descrizione
`rotation`	`TextRotation`	Le impostazioni di rotazione del testo desiderate.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setTextRotations(rotations)`

Imposta una griglia rettangolare di rotazioni del testo.

// Copies all of the text rotations from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setTextRotations(range1.getTextRotations());

Parametri

Nome	Tipo	Descrizione
`rotations`	`TextRotation[][]`	Le impostazioni di rotazione del testo desiderate.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setTextStyle(style)`

Imposta lo stile di testo per le celle dell'intervallo.

// Sets the cells in range C5:D6 to have underlined size 15 font.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("C5:D6");
var style = SpreadsheetApp.newTextStyle()
    .setFontSize(15)
    .setUnderline(true)
    .build();
range.setTextStyle(style);

Parametri

Nome	Tipo	Descrizione
`style`	`TextStyle`	Lo stile di testo desiderato.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setTextStyles(styles)`

Imposta una griglia rettangolare di stili di testo.

// Sets text styles for cells in range A1:B2
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B2");
var bold = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .build();
var otherStyle = SpreadsheetApp.newTextStyle()
    .setBold(true)
    .setUnderline(true)
    .setItalic(true)
    .setForegroundColor("#335522")
    .setFontSize(44)
    .build();
range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);

Parametri

Nome	Tipo	Descrizione
`styles`	`TextStyle[][]`	Gli stili di testo desiderati.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setValue(value)`

Imposta il valore dell'intervallo. Il valore può essere numerico, stringa, booleano o data. Se inizia con '=', viene interpretato come una formula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setValue(100);

Parametri

Nome	Tipo	Descrizione
`value`	`Object`	Il valore dell'intervallo.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setValues(values)`

Imposta una griglia rettangolare di valori (devono corrispondere alle dimensioni di questo intervallo). Se un valore inizia con =, viene interpretato come una formula.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var values = [
  [ "2.000", "1,000,000", "$2.99" ]
];

var range = sheet.getRange("B2:D2");
range.setValues(values);

Parametri

Nome	Tipo	Descrizione
`values`	`Object[][]`	Un array bidimensionale di valori.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setVerticalAlignment(alignment)`

Imposta l'allineamento verticale (dall'alto verso il basso) per l'intervallo specificato (in alto/al centro/in basso).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setVerticalAlignment("middle");

Parametri

Nome	Tipo	Descrizione
`alignment`	`String`	L'allineamento, `'top'`, `'middle'` o `'bottom'`; un valore `null` reimposta l'allineamento.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setVerticalAlignments(alignments)`

Imposta una griglia rettangolare di allineamenti verticali (devono corrispondere alle dimensioni di questo intervallo).

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var alignments = [
  [ "top", "middle", "bottom" ]
];

var range = sheet.getRange("B2:D2");
range.setVerticalAlignments(alignments);

Parametri

Nome	Tipo	Descrizione
`alignments`	`Object[][]`	Un array bidimensionale di allineamenti, `'top'`, `'middle'` o `'bottom'`; un valore `null` reimposta l'allineamento.

Ritorni

Range: questo intervallo, per il concatenamento.

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

Vedi anche

setVerticalAlignment(alignment)

`setVerticalText(isVertical)`

Consente di impostare se sovrapporre o meno il testo per le celle dell'intervallo. Se il testo è impilato verticalmente, l'impostazione di rotazione del testo in gradi viene ignorata.

// Sets all cell's in range B2:D4 to have vertically stacked text.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setVerticalText(true);

Parametri

Nome	Tipo	Descrizione
`isVertical`	`Boolean`	Indica se sovrapporre o meno il testo.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setWrap(isWrapEnabled)`

Imposta il ritorno a capo delle celle dell'intervallo specificato.

Le celle con aggregazione attivata (impostazione predefinita) vengono ridimensionate per visualizzare i relativi contenuti completi. Le celle in cui è stato disattivato il wrapping vengono visualizzate il più possibile nella cella senza ridimensionare o eseguire su più righe.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

var cell = sheet.getRange("B2");
cell.setWrap(true);

Parametri

Nome	Tipo	Descrizione
`isWrapEnabled`	`Boolean`	Indica se mandare a capo o meno il testo.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setWrapStrategies(strategies)`

Imposta una griglia rettangolare di strategie di aggregazione.

// Copies all of the wrap strategies from range A1:B2 over to range C5:D6.
var sheet = SpreadsheetApp.getActiveSheet();
var range1 = sheet.getRange("A1:B2");
var range2 = sheet.getRange("C5:D6");

range2.setWrapStrategies(range1.getWrapStrategies());

Parametri

Nome	Tipo	Descrizione
`strategies`	`WrapStrategy[][]`	Le strategie di wrapping desiderate.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setWrapStrategy(strategy)`

Imposta la strategia di testo a capo per le celle dell'intervallo.

// Sets all cells in range B2:D4 to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("B2:D4");

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parametri

Nome	Tipo	Descrizione
`strategy`	`WrapStrategy`	La strategia di wrapping desiderata.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`setWraps(isWrapEnabled)`

Consente di impostare una griglia rettangolare di criteri per il ritorno a capo automatico (deve corrispondere alle dimensioni di questo intervallo). Le celle in cui è abilitato il wrapping (impostazione predefinita) vengono ridimensionate per visualizzare il contenuto completo. Le celle con wrapping disattivato vengono visualizzate il più possibile nella cella senza ridimensionare o eseguire su più righe.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];

// The size of the two-dimensional array must match the size of the range.
var wraps = [
  [ true, true, false ]
];

var range = sheet.getRange("B2:D2");
range.setWraps(wraps);

Parametri

Nome	Tipo	Descrizione
`isWrapEnabled`	`Object[][]`	Un array bidimensionale di variabili a capo che determina se mandare a capo il testo in una cella o meno.

Ritorni

Range: questo intervallo, per il concatenamento.

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

Vedi anche

setWrap(isWrapEnabled)

`shiftColumnGroupDepth(delta)`

Modifica la profondità di raggruppamento delle colonne dell'intervallo in base al valore specificato.

In questo modo vengono creati, modificati o eliminati i gruppi che si intersecano con l'intervallo. Per i delta positivi, vengono creati e/o modificati i gruppi; per i delta negativi, i gruppi vengono eliminati e/o modificati.

Ciò non ha effetto se si riduce la profondità del gruppo sotto lo zero o sopra gli otto.

Se column group control position è BEFORE, viene visualizzato un errore quando si cerca di spostare la profondità della prima riga.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The column grouping depth is increased by 1.
range.shiftColumnGroupDepth(1);

// The column grouping depth is decreased by 1.
range.shiftColumnGroupDepth(-1);

Parametri

Nome	Tipo	Descrizione
`delta`	`Integer`	La quantità in base alla quale modificare la profondità del gruppo di colonne di questo intervallo.

Ritorni

Range: questo intervallo, per il concatenamento.

Tiri

Error: quando cerchi di spostare la profondità della prima colonna quando la posizione di controllo è GroupControlTogglePosition.BEFORE

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

`shiftRowGroupDepth(delta)`

Modifica la profondità di raggruppamento delle righe dell'intervallo in base al valore specificato.

Ciò non ha effetto se si riduce la profondità del gruppo sotto lo zero o sopra gli otto.

Se row group control position è BEFORE, viene visualizzato un errore quando si cerca di spostare la profondità della prima riga.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getActiveRange();

// The row grouping depth is increased by 1.
range.shiftRowGroupDepth(1);

// The row grouping depth is decreased by 1.
range.shiftRowGroupDepth(-1);

Parametri

Nome	Tipo	Descrizione
`delta`	`Integer`	La quantità in base alla quale modificare la profondità del gruppo di righe di questo intervallo.

Ritorni

Range: questo intervallo, per il concatenamento.

Tiri

Error: quando si cerca di spostare la profondità della prima riga quando la posizione di controllo è GroupControlTogglePosition.BEFORE

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

`sort(sortSpecObj)`

Ordina le celle nell'intervallo specificato, per colonna e ordine specificati.

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("A1:C7");

// Sorts by the values in the first column (A)
range.sort(1);

// Sorts by the values in the second column (B)
range.sort(2);

// Sorts descending by column B
range.sort({column: 2, ascending: false});

// Sorts descending by column B, then ascending by column A
// Note the use of an array
range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]);

// For rows that are sorted in ascending order, the "ascending" parameter is
// optional, and just an integer with the column can be used instead. Note that
// in general, keeping the sort specification consistent results in more readable
// code. You can express the earlier sort as:
range.sort([{column: 2, ascending: false}, 1]);

// Alternatively, if you want all columns to be in ascending order, you can use
// the following (this makes column 2 ascending)
range.sort([2, 1]);
// ... which is equivalent to
range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);

Parametri

Nome	Tipo	Descrizione
`sortSpecObj`	`Object`	Le colonne in base alle quali ordinare.

Ritorni

Range: questo intervallo, per il concatenamento.

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

`splitTextToColumns()`

Suddivide una colonna di testo in più colonne in base a un delimitatore rilevato automaticamente.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one,one,one      |                 |                 |
// 2 |two,two,two      |                 |                 |
// 3 |three,three,three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns();

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

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

`splitTextToColumns(delimiter)`

Suddivide una colonna di testo in più colonne utilizzando la stringa specificata come delimitatore personalizzato.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one#one#one      |                 |                 |
// 2 |two#two#two      |                 |                 |
// 3 |three#three#three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns('#');

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametri

Nome	Tipo	Descrizione
`delimiter`	`String`	Il delimitatore personalizzato su cui suddividere.

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

`splitTextToColumns(delimiter)`

Suddivide una colonna di testo in più colonne in base al delimitatore specificato.

// A1:A3 has the following values:
//           A                  B                 C
// 1 |one;one;one      |                 |                 |
// 2 |two;two;two      |                 |                 |
// 3 |three;three;three|                 |                 |

var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3");
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after spliting the text to columns:
//           A                  B                 C
// 1 |one              |one              |one              |
// 2 |two              |two              |two              |
// 3 |three            |three            |three            |

Parametri

Nome	Tipo	Descrizione
`delimiter`	`TextToColumnsDelimiter`	Il delimitatore preimpostato su cui dividere.

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

`trimWhitespace()`

Modifica gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella dell'intervallo. Rimuove gli spazi vuoti all'inizio e alla fine del testo di ogni cella e riduce a un unico spazio eventuali sottosequenze di spazi vuoti rimanenti.

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)'])

range.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

Ritorni

Range: questo intervallo, per il concatenamento.

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

`uncheck()`

Modifica lo stato delle caselle di controllo nell'intervallo su "Deselezionata". Ignora le celle nell'intervallo che attualmente non contengono il valore selezionato o deselezionato configurato.

// Changes the state of cells which currently contain either the checked or unchecked value
// configured in the range A1:B10 to 'unchecked'.
var range = SpreadsheetApp.getActive().getRange('A1:B10');
range.uncheck();

Ritorni

Range: questo intervallo, per il concatenamento.

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

Metodi deprecati

`getFontColor()`

Obsoleta. Sostituito da getFontColorObject()

Restituisce il colore del carattere della cella nell'angolo in alto a sinistra dell'intervallo, nella notazione CSS (ad esempio '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

Logger.log(range.getFontColor());

Ritorni

String: il colore del carattere nella notazione CSS (ad esempio '#ffffff' o 'white').

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

`getFontColors()`

Obsoleta. Sostituito da getFontColorObjects()

Restituisce i colori dei caratteri delle celle dell'intervallo nella notazione CSS (come '#ffffff' o 'white').

var ss = SpreadsheetApp.getActiveSpreadsheet();
var sheet = ss.getSheets()[0];
var range = sheet.getRange("B2:D4");

var results = range.getFontColors();

for (var i in results) {
  for (var j in results[i]) {
    Logger.log(results[i][j]);
  }
}

Ritorni

String[][]: array bidimensionale di colori dei caratteri associati alle celle dell'intervallo.

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