Questa pagina è stata tradotta dall'API Cloud Translation.

Class Range

Accedere e modificare gli intervalli dei fogli di lavoro. Un intervallo può essere una singola cella in 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 dell'intervallo come `current cell`.
`activateAsCurrentCell()`	`Range`	Imposta la cella specificata come `current cell`.
`addDeveloperMetadata(key)`	`Range`	Aggiunge i metadati dello sviluppatore con la chiave specificata all'intervallo.
`addDeveloperMetadata(key, visibility)`	`Range`	Aggiunge metadati dello 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 di bande di colonne predefinito.
`applyColumnBanding(bandingTheme)`	`Banding`	Applica all'intervallo un tema di bande di colonne specificato.
`applyColumnBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Applica un tema di bande di colonne specificato all'intervallo con le impostazioni di intestazione e piè di pagina specificate.
`applyRowBanding()`	`Banding`	Applica un tema di bande di righe predefinito all'intervallo.
`applyRowBanding(bandingTheme)`	`Banding`	Applica all'intervallo un tema di bande di righe specificato.
`applyRowBanding(bandingTheme, showHeader, showFooter)`	`Banding`	Applica un tema di bande di righe specificato all'intervallo con le impostazioni di intestazione e piè di pagina specificate.
`autoFill(destination, series)`	`void`	Riempie `destinationRange` con i dati in base a quelli presenti in questo intervallo.
`autoFillToNeighbor(series)`	`void`	Calcola un intervallo da riempire con nuovi dati in base alle celle adiacenti e lo riempie automaticamente con nuovi valori in base ai dati contenuti in questo intervallo.
`breakApart()`	`Range`	Dividi di nuovo le celle a più colonne nell'intervallo in singole celle.
`canEdit()`	`Boolean`	Determina se l'utente ha l'autorizzazione per modificare ogni cella dell'intervallo.
`check()`	`Range`	Modifica lo stato delle caselle di controllo nell'intervallo in "Selezionato".
`clear()`	`Range`	Cancella l'intervallo di contenuti e formati.
`clear(options)`	`Range`	Cancella l'intervallo di contenuti, formato, regole di convalida dei dati e/o commenti, come specificato con le opzioni avanzate indicate.
`clearContent()`	`Range`	Cancella i contenuti dell'intervallo, lasciando intatta 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 interamente contenuti nell'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.
`copyTo(destination, copyPasteType, transposed)`	`void`	Copia i dati da un intervallo di celle a un altro.
`copyTo(destination, options)`	`void`	Copia i dati da un intervallo di celle a un altro.
`copyValuesToRange(gridId, column, columnEnd, row, rowEnd)`	`void`	Copia i contenuti dell'intervallo nella posizione specificata.
`copyValuesToRange(sheet, column, columnEnd, row, rowEnd)`	`void`	Copia i contenuti dell'intervallo nella posizione specificata.
`createDataSourcePivotTable(dataSource)`	`DataSourcePivotTable`	Crea una tabella pivot vuota dell'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 oggetto DeveloperMetadataFinderApi per trovare i metadati dello sviluppatore nell'ambito di questo intervallo.
`createFilter()`	`Filter`	Crea un filtro e lo applica all'intervallo specificato nel foglio.
`createPivotTable(sourceData)`	`PivotTable`	Crea una tabella pivot vuota a partire dal `sourceData` specificato, ancorato alla prima cella di questo intervallo.
`createTextFinder(findText)`	`TextFinder`	Crea un cercatore di testo per l'intervallo, che può trovare e sostituire il testo in questo intervallo.
`deleteCells(shiftDimension)`	`void`	Elimina questo intervallo di celle.
`expandGroups()`	`Range`	Espande i gruppi compressi il cui intervallo o pulsante di controllo si interseca con questo intervallo.
`getA1Notation()`	`String`	Restituisce una descrizione in formato stringa dell'intervallo, nella notazione A1.
`getBackground()`	`String`	Restituisce il colore di sfondo della cella in alto a sinistra dell'intervallo (ad esempio, `'#ffffff'`).
`getBackgroundObject()`	`Color`	Restituisce il colore di sfondo della cella in alto a sinistra dell'intervallo.
`getBackgroundObjects()`	`Color[][]`	Restituisce i colori di sfondo delle celle nell'intervallo.
`getBackgrounds()`	`String[][]`	Restituisce i colori di sfondo delle celle nell'intervallo (ad esempio, `'#ffffff'`).
`getBandings()`	`Banding[]`	Restituisce tutte le bande applicate alle celle di questo intervallo.
`getCell(row, column)`	`Range`	Restituisce una determinata cella all'interno di un intervallo.
`getColumn()`	`Integer`	Restituisce la posizione della colonna iniziale per questo intervallo.
`getDataRegion()`	`Range`	Restituisce una copia dell'intervallo espanso nei quattro punti cardinali `Direction` per coprire tutte le celle adiacenti contenenti 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 dell'origine dati.
`getDataSourceFormulas()`	`DataSourceFormula[]`	Restituisce i `DataSourceFormula` per le celle nell'intervallo.
`getDataSourcePivotTables()`	`DataSourcePivotTable[]`	Recupera tutte le tabelle pivot dell'origine dati che si intersecano con l'intervallo.
`getDataSourceTables()`	`DataSourceTable[]`	Recupera 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 DataTable.
`getDataTable(firstRowIsHeader)`	`DataTable`	Restituisce i dati all'interno di questo intervallo come DataTable.
`getDataValidation()`	`DataValidation`	Restituisce la regola di convalida dei dati per la cella in alto a sinistra dell'intervallo.
`getDataValidations()`	`DataValidation[][]`	Restituisce le regole di convalida dei dati per tutte le celle dell'intervallo.
`getDeveloperMetadata()`	`DeveloperMetadata[]`	Recupera i metadati dello sviluppatore associati a questo intervallo.
`getDisplayValue()`	`String`	Restituisce il valore visualizzato della cella in alto a sinistra dell'intervallo.
`getDisplayValues()`	`String[][]`	Restituisce la griglia rettangolare di valori per questo intervallo.
`getFilter()`	`Filter`	Restituisce il filtro sul foglio a cui appartiene questo intervallo oppure `null` se non è presente alcun filtro sul foglio.
`getFontColorObject()`	`Color`	Restituisce il colore del carattere della cella nell'angolo in alto a sinistra dell'intervallo.
`getFontColorObjects()`	`Color[][]`	Restituisce i colori del carattere delle celle nell'intervallo.
`getFontFamilies()`	`String[][]`	Restituisce le famiglie di caratteri delle celle nell'intervallo.
`getFontFamily()`	`String`	Restituisce la famiglia di caratteri della cella nell'angolo in alto a sinistra dell'intervallo.
`getFontLine()`	`String`	Restituisce lo stile della linea 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 in alto a sinistra dell'intervallo.
`getFontSizes()`	`Integer[][]`	Restituisce le dimensioni dei caratteri delle celle nell'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 dei caratteri delle celle nell'intervallo.
`getFontWeight()`	`String`	Restituisce lo spessore del carattere (normale/grassetto) della cella nell'angolo in alto a sinistra dell'intervallo.
`getFontWeights()`	`String[][]`	Restituisce gli spessori dei caratteri delle celle nell'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 determinata cella o `null` se non è presente.
`getFormulas()`	`String[][]`	Restituisce le formule (notazione A1) per le celle nell'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 nell'intervallo.
`getLastColumn()`	`Integer`	Restituisce la posizione della colonna finale.
`getLastRow()`	`Integer`	Restituisce la posizione della riga finale.
`getMergedRanges()`	`Range[]`	Restituisce un array di oggetti `Range` che rappresentano le celle unite che si trovano completamente all'interno dell'intervallo corrente o che contengono almeno una cella nell'intervallo corrente.
`getNextDataCell(direction)`	`Range`	A partire dalla cella nella prima colonna e riga dell'intervallo, restituisce la cella successiva nella direzione specificata che è il bordo di un intervallo contiguo di celle con dati o la 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`	Ottiene la formattazione di numeri o date della cella in alto a sinistra dell'intervallo specificato.
`getNumberFormats()`	`String[][]`	Restituisce i formati di numeri o date per le celle dell'intervallo.
`getRichTextValue()`	`RichTextValue`	Restituisce il valore di testo RTF per la cella in alto a 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 per la cella in alto a sinistra dell'intervallo.
`getTextDirections()`	`TextDirection[][]`	Restituisce la direzione del testo per le celle nell'intervallo.
`getTextRotation()`	`TextRotation`	Restituisce le impostazioni di rotazione del testo per la cella in alto a sinistra dell'intervallo.
`getTextRotations()`	`TextRotation[][]`	Restituisce le impostazioni di rotazione del testo per le celle dell'intervallo.
`getTextStyle()`	`TextStyle`	Restituisce lo stile del testo per la cella in alto a sinistra dell'intervallo.
`getTextStyles()`	`TextStyle[][]`	Restituisce gli stili di testo per le celle nell'intervallo.
`getValue()`	`Object`	Restituisce il valore della cella in alto a sinistra dell'intervallo.
`getValues()`	`Object[][]`	Restituisce la griglia rettangolare di valori per questo intervallo.
`getVerticalAlignment()`	`String`	Restituisce l'allineamento verticale (in alto/al centro/in basso) della cella nell'angolo in alto a sinistra dell'intervallo.
`getVerticalAlignments()`	`String[][]`	Restituisce gli allineamenti verticali delle celle nell'intervallo.
`getWidth()`	`Integer`	Restituisce la larghezza dell'intervallo in colonne.
`getWrap()`	`Boolean`	Restituisce un valore che indica se il testo nella cella va a capo.
`getWrapStrategies()`	`WrapStrategy[][]`	Restituisce le strategie di ritorno a capo per le celle dell'intervallo.
`getWrapStrategy()`	`WrapStrategy`	Restituisce la strategia di ritorno a capo del testo per la cella in alto a sinistra dell'intervallo.
`getWraps()`	`Boolean[][]`	Restituisce un valore che indica se il testo nelle celle va a capo.
`insertCells(shiftDimension)`	`Range`	Inserisce celle vuote in questo intervallo.
`insertCheckboxes()`	`Range`	Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con `true` per le caselle selezionate e `false` per quelle non selezionate.
`insertCheckboxes(checkedValue)`	`Range`	Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con un valore personalizzato per la casella selezionata e la stringa vuota per la casella non selezionata.
`insertCheckboxes(checkedValue, uncheckedValue)`	`Range`	Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionato e non selezionato.
`isBlank()`	`Boolean`	Restituisce `true` se l'intervallo è completamente vuoto.
`isChecked()`	`Boolean`	Restituisce un valore che indica se tutte le celle dell'intervallo hanno la casella di controllo selezionata.
`isEndColumnBounded()`	`Boolean`	Determina se la fine dell'intervallo è associata a una colonna specifica.
`isEndRowBounded()`	`Boolean`	Determina se la fine dell'intervallo è associata a una riga specifica.
`isPartOfMerge()`	`Boolean`	Restituisce `true` se le celle dell'intervallo corrente si sovrappongono a celle unite.
`isStartColumnBounded()`	`Boolean`	Determina se l'inizio dell'intervallo è associato a una colonna specifica.
`isStartRowBounded()`	`Boolean`	Determina se l'inizio dell'intervallo è associato a una riga specifica.
`merge()`	`Range`	Unisce le celle dell'intervallo in un unico blocco.
`mergeAcross()`	`Range`	Unire le celle nell'intervallo tra le colonne dell'intervallo.
`mergeVertically()`	`Range`	Unisce le celle nell'intervallo.
`moveTo(target)`	`void`	Taglia e incolla (sia il formato che i valori) da questo intervallo all'intervallo di destinazione.
`offset(rowOffset, columnOffset)`	`Range`	Restituisce un nuovo intervallo che viene spostato rispetto a questo intervallo del 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 dall'intervallo corrente delle righe e delle colonne specificate e con l'altezza specificata in celle.
`offset(rowOffset, columnOffset, numRows, numColumns)`	`Range`	Restituisce un nuovo intervallo relativo all'intervallo corrente, il cui punto in alto a sinistra è spostato dall'intervallo corrente delle righe e delle colonne specificate e con l'altezza e la larghezza specificate in celle.
`protect()`	`Protection`	Crea un oggetto che può proteggere l'intervallo dalla modifica, tranne che da parte degli 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 all'interno di questo intervallo che contengono valori duplicati di valori in qualsiasi riga precedente.
`removeDuplicates(columnsToCompare)`	`Range`	Rimuove le righe all'interno di questo intervallo che contengono valori nelle colonne specificate che sono duplicati dei valori di qualsiasi riga precedente.
`setBackground(color)`	`Range`	Imposta il colore di sfondo di tutte le celle nell'intervallo nella notazione CSS (ad esempio `'#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 (deve corrispondere alle dimensioni di questo intervallo).
`setBackgroundRGB(red, green, blue)`	`Range`	Imposta lo sfondo sul colore specificato utilizzando i valori RGB (numeri interi compresi tra 0 e 255 inclusi).
`setBackgrounds(color)`	`Range`	Imposta una griglia rettangolare di colori di sfondo (deve 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`	Imposta una griglia rettangolare di colori dei caratteri (deve corrispondere alle dimensioni di questo intervallo).
`setFontColors(colors)`	`Range`	Imposta una griglia rettangolare di colori dei caratteri (deve corrispondere alle dimensioni di questo intervallo).
`setFontFamilies(fontFamilies)`	`Range`	Imposta una griglia rettangolare di famiglie di caratteri (deve corrispondere alle dimensioni di 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 dell'intervallo specificato (`'underline'`, `'line-through'` o `'none'`).
`setFontLines(fontLines)`	`Range`	Imposta una griglia rettangolare di stili di linea (deve corrispondere alle dimensioni di questo intervallo).
`setFontSize(size)`	`Range`	Imposta la dimensione del carattere, che corrisponde alla dimensione in punti da utilizzare.
`setFontSizes(sizes)`	`Range`	Imposta una griglia rettangolare di dimensioni dei caratteri (deve 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 di carattere (deve 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 del carattere (deve 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 (deve corrispondere alle dimensioni di questo intervallo).
`setFormulasR1C1(formulas)`	`Range`	Imposta una griglia rettangolare di formule (deve 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 (deve corrispondere alle dimensioni di questo intervallo).
`setNumberFormat(numberFormat)`	`Range`	Imposta il formato di numero o data sulla stringa di formattazione specificata.
`setNumberFormats(numberFormats)`	`Range`	Imposta una griglia rettangolare di formati di numeri o date (deve 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`	Specifica se l'intervallo deve mostrare 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`	Imposta le impostazioni di rotazione del testo per le celle nell'intervallo.
`setTextRotation(rotation)`	`Range`	Imposta le impostazioni di rotazione del testo per le celle nell'intervallo.
`setTextRotations(rotations)`	`Range`	Imposta una griglia rettangolare di rotazioni del testo.
`setTextStyle(style)`	`Range`	Imposta lo stile del testo per le celle nell'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 (deve 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 (deve corrispondere alle dimensioni di questo intervallo).
`setVerticalText(isVertical)`	`Range`	Specifica se impilare o meno il testo per le celle nell'intervallo.
`setWrap(isWrapEnabled)`	`Range`	Imposta il ritorno a capo della cella dell'intervallo specificato.
`setWrapStrategies(strategies)`	`Range`	Imposta una griglia rettangolare di strategie di wrapping.
`setWrapStrategy(strategy)`	`Range`	Imposta la strategia di ritorno a capo per le celle nell'intervallo.
`setWraps(isWrapEnabled)`	`Range`	Imposta una griglia rettangolare di criteri di ritorno a capo (deve corrispondere alle dimensioni di questo intervallo).
`shiftColumnGroupDepth(delta)`	`Range`	Modifica la profondità del raggruppamento delle colonne dell'intervallo in base alla quantità specificata.
`shiftRowGroupDepth(delta)`	`Range`	Modifica la profondità del raggruppamento delle righe dell'intervallo in base alla quantità specificata.
`sort(sortSpecObj)`	`Range`	Ordina le celle nell'intervallo specificato in base alla colonna e all'ordine specificati.
`splitTextToColumns()`	`void`	Divide una colonna di testo in più colonne in base a un delimitatore rilevato automaticamente.
`splitTextToColumns(delimiter)`	`void`	Divide una colonna di testo in più colonne utilizzando la stringa specificata come delimitatore personalizzato.
`splitTextToColumns(delimiter)`	`void`	Divide una colonna di testo in più colonne in base al delimitatore specificato.
`trimWhitespace()`	`Range`	Elimina gli spazi vuoti (come spazi, tabulazioni o nuove righe) in ogni cella di questo intervallo.
`uncheck()`	`Range`	Modifica lo stato delle caselle di controllo nell'intervallo in "non selezionato".

Metodi ritirati

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 del carattere delle celle nell'intervallo nella notazione CSS (ad esempio `'#ffffff'` o `'white'`).

Documentazione dettagliata

`activate()`

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

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

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

Indietro

Range: questo intervallo, per il concatenamento.

`activateAsCurrentCell()`

Imposta la cella specificata come current cell.

Se la cella specificata è presente in un intervallo esistente, questo intervallo 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 costituito da una cella, altrimenti viene generata un'eccezione.

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

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

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

Indietro

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 i metadati dello sviluppatore con la chiave specificata 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 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.

Indietro

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 dello 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.

Indietro

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.

Indietro

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.

Indietro

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 di bande di colonne predefinito. Per impostazione predefinita, la banda ha un'intestazione e nessun 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(),
);

Indietro

Banding: la nuova banda.

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 di bande di colonne specificato. Per impostazione predefinita, la banda ha un colore di intestazione e nessun colore di 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 cromatico da applicare alle colonne nell'intervallo.

Indietro

Banding: la nuova banda.

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 di bande di colonne specificato 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 cromatico da applicare alle colonne nell'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 a bande viene applicato all'ultima colonna.

Indietro

Banding: la nuova banda.

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 un tema di bande di righe predefinito all'intervallo. Per impostazione predefinita, la banda ha un'intestazione e nessun 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);

Indietro

Banding: le bande.

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 di bande di righe specificato. Per impostazione predefinita, la banda ha un'intestazione e nessun 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 cromatico da applicare alle righe dell'intervallo.

Indietro

Banding: la nuova banda.

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 un tema di bande di righe specificato all'intervallo con le impostazioni di intestazione e piè di pagina specificate.

// 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 cromatico da applicare alle righe dell'intervallo.
`showHeader`	`Boolean`	Se `true`, il colore dell'intestazione del tema a bande viene applicato alla prima riga.
`showFooter`	`Boolean`	Se `true`, il colore del piè di pagina del tema a bande viene applicato all'ultima riga.

Indietro

Banding: la nuova banda.

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)`

Riempie destinationRange con i dati in base a quelli presenti in questo intervallo. I nuovi valori sono determinati anche dal tipo series specificato. L'intervallo di destinazione deve contenere questo intervallo ed estenderlo in una sola direzione. Ad esempio, il seguente riempie A1:A20 con una serie di numeri crescenti in base ai valori attuali in A1:A4:

const sheet = SpreadsheetApp.getActiveSheet();

// Has values [1, 2, 3, 4].
const sourceRange = sheet.getRange('A1:A4');
// The range to fill with values.
const 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 di riempimento automatico da utilizzare per calcolare i nuovi valori. L'effetto di questa serie varia in base al tipo e alla quantità di 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 da riempire con nuovi dati in base alle celle adiacenti e lo riempie automaticamente con nuovi valori in base ai dati contenuti in questo intervallo. Questi nuovi valori sono determinati anche dal tipo series specificato.

L'intervallo di destinazione calcolato prende in considerazione i dati circostanti per determinare dove devono essere inseriti 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 è compilato con una serie di numeri crescenti e questo metodo viene chiamato nell'intervallo B1:B4 che contiene una serie di date, i nuovi valori vengono inseriti solo in B5:B20. In questo modo, i nuovi valori "aderiscono" alle celle che contengono valori nella colonna A.

const sheet = SpreadsheetApp.getActiveSheet();

// A1:A20 has values [1, 2, 3, ... 20].
// B1:B4 has values [1/1/2017, 1/2/2017, ...]
const 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 di riempimento automatico da utilizzare per calcolare i nuovi valori. L'effetto di questa serie varia in base al tipo e alla quantità di 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()`

Dividi di nuovo le celle a più colonne nell'intervallo in singole celle.

Chiamare questa funzione in un intervallo equivale a selezionare un intervallo e 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();

Indietro

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 ha l'autorizzazione per modificare ogni cella dell'intervallo. Il proprietario del foglio di lavoro può sempre modificare gli intervalli e i 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());

Indietro

Boolean: true se l'utente dispone dell'autorizzazione per modificare ogni cella dell'intervallo; false altrimenti.

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 "Selezionato". Ignora le celle dell'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'.
const range = SpreadsheetApp.getActive().getRange('A1:B10');
range.check();

Indietro

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.

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

const range = sheet.getRange('A1:D10');
range.clear();

Indietro

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, formato, regole di convalida dei dati e/o commenti, come specificato con le opzioni avanzate indicate. 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`	Specifica se cancellare solo i commenti.
`contentsOnly`	`Boolean`	Se cancellare solo i contenuti.
`formatOnly`	`Boolean`	Se cancellare solo il formato; tieni presente che la cancellazione del formato cancella anche le regole di convalida dei dati.
`validationsOnly`	`Boolean`	Se cancellare solo le regole di convalida dei dati.
`skipFilteredRows`	`Boolean`	Indica se evitare di cancellare le righe filtrate.

Indietro

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, lasciando intatta la formattazione.

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

const range = sheet.getRange('A1:D10');
range.clearContent();

Indietro

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.
const range = SpreadsheetApp.getActive().getRange('A1:B5');
range.clearDataValidations();

Indietro

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 per la cella o le celle nell'intervallo, ma non vengono reimpostate le regole di formattazione dei numeri.

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

const range = sheet.getRange('A1:D10');
range.clearFormat();

Indietro

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.

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

const range = sheet.getRange('A1:D10');
range.clearNote();

Indietro

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 interamente contenuti nell'intervallo. Se nessun gruppo rientra completamente nell'intervallo, viene compresso il gruppo espanso più profondo che rientra parzialmente nell'intervallo.

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

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

Indietro

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 è più grande o più piccola dell'intervallo di origine, quest'ultimo viene ripetuto o troncato di conseguenza. Tieni presente che questo metodo copia solo la formattazione.

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

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

const 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 di destinazione.
`columnEnd`	`Integer`	La colonna finale dell'intervallo di destinazione.
`row`	`Integer`	La riga iniziale dell'intervallo di destinazione.
`rowEnd`	`Integer`	L'ultima riga dell'intervallo di destinazione.

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)`

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

const 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 di destinazione.
`columnEnd`	`Integer`	La colonna finale dell'intervallo di destinazione.
`row`	`Integer`	La riga iniziale dell'intervallo di destinazione.
`rowEnd`	`Integer`	L'ultima riga dell'intervallo di destinazione.

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. Vengono copiati sia i valori che la formattazione.

// The code below copies the first 5 columns over to the 6th column.
const sheet = SpreadsheetApp.getActiveSheet();
const 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; è rilevante 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

`copyTo(destination, copyPasteType, transposed)`

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

// The code below copies only the values of the first 5 columns over to the 6th
// column.
const 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; è rilevante solo la posizione della cella in alto a sinistra.
`copyPasteType`	`CopyPasteType`	Un tipo che specifica come vengono incollati i contenuti dell'intervallo nella destinazione.
`transposed`	`Boolean`	Indica se l'intervallo deve essere incollato con l'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. Per impostazione predefinita vengono copiati sia i valori sia la formattazione, ma questa impostazione può essere ignorata utilizzando argomenti avanzati.

// The code below copies only the values of the first 5 columns over to the 6th
// column.
const 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; è rilevante solo la posizione della cella in alto a 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 i contenuti dell'intervallo nella posizione specificata. Se la destinazione è più grande o più piccola dell'intervallo di origine, quest'ultimo viene ripetuto o troncato di conseguenza.

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

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

const 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 di destinazione.
`columnEnd`	`Integer`	La colonna finale dell'intervallo di destinazione.
`row`	`Integer`	La riga iniziale dell'intervallo di destinazione.
`rowEnd`	`Integer`	L'ultima riga dell'intervallo di destinazione.

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 i contenuti dell'intervallo nella posizione specificata. Se la destinazione è più grande o più piccola dell'intervallo di origine, quest'ultimo viene ripetuto o troncato di conseguenza.

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

const 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 di destinazione.
`columnEnd`	`Integer`	La colonna finale dell'intervallo di destinazione.
`row`	`Integer`	La riga iniziale dell'intervallo di destinazione.
`rowEnd`	`Integer`	L'ultima riga dell'intervallo di destinazione.

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 dell'origine dati, ancorata alla prima cella di questo intervallo.

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

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

const 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.

Indietro

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 dell'origine dati.

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

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

Parametri

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

Indietro

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 oggetto DeveloperMetadataFinderApi per trovare i metadati dello sviluppatore nell'ambito di questo intervallo. I metadati rientrano nell'ambito dell'intervallo solo se sono interamente contenuti al suo interno. 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());

Indietro

DeveloperMetadataFinder: uno strumento di ricerca dei metadati dello sviluppatore per cercare i metadati nell'ambito di questo intervallo.

`createFilter()`

Crea un filtro e lo applica all'intervallo specificato nel 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().

const ss = SpreadsheetApp.getActiveSheet();
const 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() {
  const filter = range.getFilter();
  const criteria =
      SpreadsheetApp.newFilterCriteria().whenCellNotEmpty().build();
  filter.setColumnFilterCriteria(2, criteria);
}

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

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

Indietro

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 a partire dal 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.

Indietro

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 un cercatore di testo per l'intervallo, che può trovare e sostituire il testo in questo intervallo.

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

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

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

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

Parametri

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

Indietro

TextFinder: il 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.

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

const range = sheet.getRange('A1:D10');
range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);

Parametri

Nome	Tipo	Descrizione
`shiftDimension`	`Dimension`	La dimensione lungo la 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 pulsante di controllo si interseca con questo intervallo. La posizione del pulsante di controllo è l'indice in cui viene visualizzato, direttamente prima o dopo il gruppo a seconda delle impostazioni. Se in una stessa posizione è presente più di un gruppo, viene espanso il gruppo meno profondo.

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

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

Indietro

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 in formato stringa dell'intervallo, nella notazione A1.

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

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

Indietro

String: la descrizione della stringa dell'intervallo in 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 dell'intervallo (ad esempio, '#ffffff').

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

const cell = sheet.getRange('B5');
Logger.log(cell.getBackground());

Indietro

String: il codice 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 in alto a sinistra dell'intervallo.

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

const cell = sheet.getRange('B5');
Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());

Indietro

Color: il colore di sfondo della cella in alto a 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 nell'intervallo.

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

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

Indietro

Color[][]: un array 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 nell'intervallo (ad esempio, '#ffffff').

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

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

Indietro

String[][]: un 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 alle celle 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');

// 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 (const banding of bandings) {
  console.log(banding.getSecondRowColor());
}

Indietro

Banding[]: tutte le bande applicate alle celle di 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.

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

const 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
const cell = range.getCell(1, 1);
Logger.log(cell.getValue());

Parametri

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

Indietro

Range: un intervallo contenente una singola cella in corrispondenza delle 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 della colonna iniziale per questo intervallo.

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

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

Indietro

Integer: la posizione della 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 punti cardinali Direction per coprire tutte le celle adiacenti contenenti dati. Se l'intervallo è circondato da celle vuote che non includono quelle lungo le diagonali, viene restituito l'intervallo stesso. È un'operazione simile alla selezione dell'intervallo e alla digitazione di Ctrl+A nell'editor.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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());

Indietro

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 di dati accanto all'intervallo organizzati come una tabella. L'intervallo espanso copre tutte le celle adiacenti con dati nella dimensione specificata, inclusi i limiti della tabella. Se l'intervallo originale è circondato 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 Shift+Space per le righe nell'editor.

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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 lungo la quale espandere l'intervallo.

Indietro

Range: la regione di dati dell'intervallo o un intervallo che copre ogni colonna o ogni riga dell'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 dell'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);

Indietro

DataSourceFormula: il 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());

Indietro

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()`

Recupera 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());

Indietro

DataSourcePivotTable[]: un elenco delle tabelle pivot delle 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

`getDataSourceTables()`

Recupera 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());

Indietro

DataSourceTable[]: un elenco delle tabelle delle 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() {
  const ss = SpreadsheetApp.openById(
      '1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c',
  );
  const sheet = ss.getSheetByName('ContinentData');
  const range = sheet.getRange('A1:B8');

  const 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>

Indietro

String: un URL per questo intervallo come origine dati che può essere trasmessa 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 DataTable.

// 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();

Indietro

DataTable: i dati come tabella di dati.

`getDataTable(firstRowIsHeader)`

Restituisce i dati all'interno di questo intervallo come DataTable.

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

// Calling this method with "true" sets the first line to be the title of the
// axes
const 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.
const chart = Charts.newBarChart()
                  .setDataTable(datatable)
                  .setOption('title', 'Your Title Here')
                  .build();

Parametri

Nome	Tipo	Descrizione
`firstRowIsHeader`	`Boolean`	Indica se la prima riga deve essere trattata come intestazione.

Indietro

DataTable: i dati come tabella.

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 in alto a sinistra dell'intervallo. Se la convalida dei dati non è stata impostata nella cella, questo metodo restituisce null.

// Log information about the data validation rule for cell A1.
const cell = SpreadsheetApp.getActive().getRange('A1');
const rule = cell.getDataValidation();
if (rule != null) {
  const criteria = rule.getCriteriaType();
  const 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.');
}

Indietro

DataValidation: la regola di convalida dei dati per la cella in alto a 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 su 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.
const oldDates = [new Date('1/1/2013'), new Date('12/31/2013')];
const newDates = [new Date('1/1/2014'), new Date('12/31/2014')];
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns());
const rules = range.getDataValidations();

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

    if (rule != null) {
      const criteria = rule.getCriteriaType();
      const 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);

Indietro

DataValidation[][]: un array bidimensionale di regole di convalida dei dati 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

`getDeveloperMetadata()`

Recupera 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()}`);
}

Indietro

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 in alto a sinistra dell'intervallo. Il valore è un String. Il valore visualizzato tiene conto della formattazione di data, ora e valuta, inclusi i formati applicati automaticamente dall'impostazione delle 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());

Indietro

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 una matrice 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 dall'impostazione delle impostazioni internazionali del foglio di lavoro. Le celle vuote sono rappresentate da una stringa vuota nell'array. Ricorda che, mentre un indice di intervallo inizia da 1, 1, l'array JavaScript è 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.
const values =
    SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues();
Logger.log(values[0][0]);

Indietro

String[][]: un 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 sul foglio a cui appartiene questo intervallo oppure null se non è presente alcun filtro sul foglio.

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

Indietro

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 in alto a sinistra dell'intervallo.

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

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

Indietro

Color: il colore del carattere 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

`getFontColorObjects()`

Restituisce i colori del carattere delle celle nell'intervallo.

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

const results = range.getFontColorObjects();

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

Indietro

Color[][]: un 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 nell'intervallo.

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

const results = range.getFontFamilies();

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

Indietro

String[][]: un 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 in alto a sinistra dell'intervallo.

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

Logger.log(range.getFontFamily());

Indietro

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 linea della cella nell'angolo in alto a sinistra dell'intervallo ('underline', 'line-through' o 'none').

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

Logger.log(range.getFontLine());

Indietro

String: la 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').

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

const results = range.getFontLines();

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

Indietro

String[][]: un array bidimensionale di linee 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

`getFontSize()`

Restituisce la dimensione del carattere in punti della cella nell'angolo in alto a sinistra dell'intervallo.

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

Logger.log(range.getFontSize());

Indietro

Integer: le dimensioni 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 nell'intervallo.

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

const results = range.getFontSizes();

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

Indietro

Integer[][]: un array bidimensionale delle dimensioni del 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

`getFontStyle()`

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

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

Logger.log(range.getFontStyle());

Indietro

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 dei caratteri delle celle nell'intervallo.

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

const results = range.getFontStyles();

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

Indietro

String[][]: un array bidimensionale di stili di 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

`getFontWeight()`

Restituisce lo spessore del carattere (normale/grassetto) della cella nell'angolo in alto a sinistra dell'intervallo.

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

Logger.log(range.getFontWeight());

Indietro

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 gli spessori dei caratteri delle celle nell'intervallo.

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

const results = range.getFontWeights();

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

Indietro

String[][]: un array bidimensionale di spessori del 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.

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

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

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

Indietro

String: la formula per la 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 determinata cella o null se non è presente.

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

const range = sheet.getRange('B5');
const formula = range.getFormulaR1C1();
Logger.log(formula);

Indietro

String: la formula 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

`getFormulas()`

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

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

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

Indietro

String[][]: un array 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 bidimensionale sono null per le celle senza formula.

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

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

Indietro

String[][]: un array 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.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const range = sheet.getRange('B2:D4');

Logger.log(range.getGridId());

Indietro

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.

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

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

Indietro

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.

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

Logger.log(range.getHorizontalAlignment());

Indietro

String: l'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 nell'intervallo.

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

const results = range.getHorizontalAlignments();

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

Indietro

String[][]: un array bidimensionale di allineamenti orizzontali 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

`getLastColumn()`

Restituisce la posizione della colonna finale.

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

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

Indietro

Integer: la 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.

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

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

Indietro

Integer: la 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 rappresentano le celle unite che si trovano completamente all'interno dell'intervallo corrente o che contengono almeno una cella nell'intervallo corrente.

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

const range = sheet.getRange('A1:B3');

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

Indietro

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

`getNextDataCell(direction)`

A partire dalla cella nella prima colonna e riga dell'intervallo, restituisce la cella successiva nella direzione specificata che è il bordo di un intervallo contiguo di celle con dati o la cella sul bordo del foglio di lavoro in quella direzione. Equivale a digitare Ctrl+[arrow key] nell'editor.

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

const 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 del bordo dell'area dati successiva.

Indietro

Range: la cella del 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.

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

Logger.log(range.getNote());

Indietro

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.

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

const results = range.getNotes();

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

Indietro

String[][]: un 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.

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

const range = sheet.getRange('B2:D5');
Logger.log(range.getNumColumns());

Indietro

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.

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

const range = sheet.getRange('B2:D5');
Logger.log(range.getNumRows());

Indietro

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()`

Ottiene la formattazione di numeri o date della cella in alto a sinistra dell'intervallo specificato. I pattern di formato restituiti sono descritti nella documentazione dell'API Sheets.

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

const cell = sheet.getRange('C4');
Logger.log(cell.getNumberFormat());

Indietro

String: il formato numerico della cella in alto a 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 i formati di numeri o date per le celle dell'intervallo. I pattern di formato restituiti sono descritti nella documentazione dell'API Sheets.

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

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

Indietro

String[][]: un 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 di testo RTF per la cella in alto a sinistra dell'intervallo o null se il valore della cella non è testo.

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

Indietro

RichTextValue: il valore RTF della cella in alto a sinistra nell'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
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B5:C6');
const values = range.getRichTextValues();

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

Indietro

RichTextValue[][]: un 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().

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

const range = sheet.getRange('B2');
Logger.log(range.getRow());

Indietro

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().

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

const range = sheet.getRange('B2');
Logger.log(range.getRowIndex());

Indietro

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());

Indietro

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 per la cella in alto a sinistra dell'intervallo. Restituisce null se la direzione del testo della cella è determinata con il rilevamento automatico.

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

Indietro

TextDirection: la direzione del testo 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

`getTextDirections()`

Restituisce la direzione del testo per le celle nell'intervallo. Le voci nell'array bidimensionale sono null per le celle che utilizzano il rilevamento automatico.

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

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

Indietro

TextDirection[][]: un 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 in alto a sinistra dell'intervallo.

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

const cell = sheet.getRange('A1');
Logger.log(cell.getTextRotation());

Indietro

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.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

const results = range.getTextRotations();

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

Indietro

TextRotation[][]: un array bidimensionale di rotazioni del testo 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

`getTextStyle()`

Restituisce lo stile del testo per la cella in alto a sinistra dell'intervallo.

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

Indietro

TextStyle: lo stile del testo 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

`getTextStyles()`

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

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

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

Indietro

TextStyle[][]: un 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 dell'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());

Indietro

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 una matrice 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 mentre un indice di intervallo inizia da 1, 1, l'array JavaScript è 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.
const values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues();
Logger.log(values[0][0]);

Nelle app web, un 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 un tipo primitivo JavaScript supportato, ad esempio Number, Boolean o String.

Indietro

Object[][]: un 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 (in alto/al centro/in basso) della cella nell'angolo in alto a sinistra dell'intervallo.

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

Logger.log(range.getVerticalAlignment());

Indietro

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 nell'intervallo.

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

const results = range.getVerticalAlignments();

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

Indietro

String[][]: un array bidimensionale di allineamenti verticali 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

`getWidth()`

Restituisce la larghezza dell'intervallo in 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());

Indietro

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 un valore che indica se il testo nella cella va a capo. Per una strategia di wrapping più granulare, utilizza getWrapStrategy().

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

Logger.log(range.getWrap());

Indietro

Boolean: indica se il testo in questa cella va a capo o meno.

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 ritorno a capo per le celle dell'intervallo.

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

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

Indietro

WrapStrategy[][]: un array bidimensionale di strategie di disposizione 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

`getWrapStrategy()`

Restituisce la strategia di ritorno a capo del testo per la cella in alto a sinistra dell'intervallo.

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

Indietro

WrapStrategy: la strategia di ritorno a capo 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 va a capo. Per una strategia di wrapping più granulare, utilizza getWrapStrategies().

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

const results = range.getVerticalAlignments();

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

Indietro

Boolean[][]: un array bidimensionale di allineamenti verticali 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

`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 lontano dall'intervallo inserito.

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

const range = sheet.getRange('A1:D10');
range.insertCells(SpreadsheetApp.Dimension.COLUMNS);

Parametri

Nome	Tipo	Descrizione
`shiftDimension`	`Dimension`	La dimensione lungo la quale spostare i dati esistenti.

Indietro

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 caselle di controllo in ogni cella dell'intervallo, configurate con true per le caselle selezionate e false per quelle non selezionate. Imposta il valore di tutte le celle dell'intervallo su false.

const 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();

Indietro

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, configurate con un valore personalizzato per la casella selezionata e la stringa vuota per la casella non selezionata. Imposta il valore di ogni cella nell'intervallo sulla stringa vuota.

const 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.

Indietro

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 selezionato e non selezionato. Imposta il valore di ogni cella nell'intervallo sul valore personalizzato non selezionato.

const 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 non selezionato per la convalida dei dati della casella di controllo.

Indietro

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.

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

Logger.log(range.isBlank());

Indietro

Boolean se l'intervallo è vuoto; true altrimenti.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

`isChecked()`

Restituisce un valore che indica se tutte le celle dell'intervallo hanno la casella di controllo selezionata. Restituisce null se alcune celle sono selezionate e le altre deselezionate o se alcune celle non hanno la convalida dei dati della casella di controllo.

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

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

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

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

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

Indietro

Boolean: true se tutte le celle dell'intervallo sono selezionate, false se tutte le celle dell'intervallo non sono selezionate o null se una delle celle non è selezionata o non ha la convalida dei dati della casella di controllo.

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 colonna specifica. 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 righe 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 column and logs
// it to the console.
console.log(range.isEndColumnBounded());

Indietro

Boolean: true se la fine dell'intervallo è associata a una colonna specifica; false altrimenti.

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 riga specifica. Ad esempio, per gli intervalli A1:B10 o 3:7, 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());

Indietro

Boolean - true se la fine dell'intervallo è associata a una riga specifica; false altrimenti.

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 dell'intervallo corrente si sovrappongono a celle unite.

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

const range = sheet.getRange('A1:B3');

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

Indietro

Boolean: true se l'intervallo si sovrappone a celle unite, altrimenti restituisce false.

`isStartColumnBounded()`

Determina se l'inizio dell'intervallo è associato a una colonna specifica. Ad esempio, per gli intervalli A1:B10 o B:B, associati a 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());

Indietro

Boolean: true se l'inizio dell'intervallo è associato a una colonna specifica; false altrimenti.

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 riga specifica. 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 particolare 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());

Indietro

Boolean: true se l'inizio dell'intervallo è associato a una riga specifica; false altrimenti.

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.

const sheet = SpreadsheetApp.getActiveSheet();

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

Indietro

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()`

Unire le celle nell'intervallo tra le colonne dell'intervallo.

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

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

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

Indietro

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 le celle nell'intervallo.

const 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();

Indietro

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 di destinazione.

// The code below moves the first 5 columns over to the 6th column
const 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; è rilevante 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 rispetto a questo intervallo del numero specificato di righe e colonne (che può essere negativo). Il nuovo intervallo ha le stesse dimensioni di quello originale.

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

const cell = sheet.getRange('A1');

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

Parametri

Nome	Tipo	Descrizione
`rowOffset`	`Integer`	Il numero di righe verso il basso dalla 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 della cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le colonne a sinistra della cella in alto a sinistra dell'intervallo.

Indietro

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 dall'intervallo corrente delle righe e delle colonne specificate e con l'altezza specificata in celle.

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

const cell = sheet.getRange('A1');

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

Parametri

Nome	Tipo	Descrizione
`rowOffset`	`Integer`	Il numero di righe verso il basso dalla 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 della cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le colonne a sinistra della cella in alto a sinistra dell'intervallo.
`numRows`	`Integer`	L'altezza in righe del nuovo intervallo.

Indietro

Range: questo intervallo, per il concatenamento.

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

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

const cell = sheet.getRange('A1');

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

Parametri

Nome	Tipo	Descrizione
`rowOffset`	`Integer`	Il numero di righe verso il basso dalla 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 della cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le colonne a sinistra della cella in alto a sinistra dell'intervallo.
`numRows`	`Integer`	L'altezza in righe del nuovo intervallo.
`numColumns`	`Integer`	La larghezza in colonne del nuovo intervallo.

Indietro

Range: questo intervallo, per il concatenamento.

`protect()`

Crea un oggetto che può proteggere l'intervallo dalla modifica, tranne che da parte degli utenti che dispongono dell'autorizzazione. Finché lo script non modifica l'elenco degli 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 che l'intervallo rimane 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 modificare la cella, l'utente non è autorizzato a modificarla.

// Protect range A1:B10, then remove all other users from the list of editors.
const ss = SpreadsheetApp.getActive();
const range = ss.getRange('A1:B10');
const 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.
const me = Session.getEffectiveUser();
protection.addEditor(me);
protection.removeEditors(protection.getEditors());
if (protection.canDomainEdit()) {
  protection.setDomainEdit(false);
}

Indietro

Protection: un 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.

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

// Randomizes the range
range.randomize();

Indietro

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.

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

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

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

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

Indietro

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 all'interno di questo intervallo che contengono valori duplicati di valori in qualsiasi riga precedente. Le righe con valori identici ma diverso utilizzo di maiuscole e minuscole, oppure con formattazione o formule diverse, vengono considerate duplicate. Questo metodo rimuove anche le righe duplicate nascoste dalla visualizzazione (ad esempio a causa di un filtro). I contenuti al di fuori di questo intervallo non vengono rimossi.

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

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

Indietro

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 all'interno di questo intervallo che contengono valori nelle colonne specificate che sono duplicati dei valori di qualsiasi riga precedente. Le righe con valori identici ma diverso utilizzo di maiuscole e minuscole, oppure con formattazione o formule diverse, vengono considerate duplicate. Questo metodo rimuove anche le righe duplicate nascoste dalla visualizzazione (ad esempio a causa di un filtro). I contenuti al di fuori di questo intervallo non vengono rimossi.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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 i valori duplicati. Se non vengono fornite colonne, vengono analizzate tutte le colonne per rilevare i duplicati.

Indietro

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 nell'intervallo nella notazione CSS (ad esempio '#ffffff' o 'white').

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

const range = sheet.getRange('B2:D5');
range.setBackground('red');

Parametri

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

Indietro

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.

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

const 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 di sfondo.

Indietro

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 (deve corrispondere alle dimensioni di questo intervallo).

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

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

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

const 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.

Indietro

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 i valori RGB (numeri interi compresi tra 0 e 255 inclusi).

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

const 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 nella notazione RGB.
`green`	`Integer`	Il valore del verde nella notazione RGB.
`blue`	`Integer`	Il valore del blu nella notazione RGB.

Indietro

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 (deve corrispondere alle dimensioni di questo intervallo). I colori sono in notazione CSS (ad esempio '#ffffff' o 'white').

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

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

const cell = sheet.getRange('B5:D6');
cell.setBackgrounds(colors);

Parametri

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

Indietro

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).

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

const 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, `null` per nessuna modifica.
`left`	`Boolean`	`true` per il bordo, `false` per nessuno, `null` per nessuna modifica.
`bottom`	`Boolean`	`true` per il bordo, `false` per nessuno, `null` per nessuna modifica.
`right`	`Boolean`	`true` per il bordo, `false` per nessuno, `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.

Indietro

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 la notazione CSS (ad esempio '#ffffff' o 'white').

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

const 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, `null` per nessuna modifica.
`left`	`Boolean`	`true` per il bordo, `false` per nessuno, `null` per nessuna modifica.
`bottom`	`Boolean`	`true` per il bordo, `false` per nessuno, `null` per nessuna modifica.
`right`	`Boolean`	`true` per il bordo, `false` per nessuno, `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 (continuo).

Indietro

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.
const cell = SpreadsheetApp.getActive().getRange('A1');
const range = SpreadsheetApp.getActive().getRange('B1:B10');
const 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.

Indietro

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 accetta un array bidimensionale di convalide dei dati, indicizzato per riga e poi per colonna. Le dimensioni dell'array devono corrispondere a quelle dell'intervallo.

// Set the data validation rules for Sheet1!A1:B5 to require a value from
// Sheet2!A1:A10.
const destinationRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5');
const sourceRange =
    SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10');
const rule =
    SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build();
const rules = destinationRange.getDataValidations();
for (let i = 0; i < rules.length; i++) {
  for (let 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.

Indietro

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').

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

const cell = sheet.getRange('B2');
cell.setFontColor('red');

Parametri

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

Indietro

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.

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

const 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.

Indietro

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)`

Imposta una griglia rettangolare di colori dei caratteri (deve corrispondere alle dimensioni di questo intervallo).

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

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

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

const 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.

Indietro

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)`

Imposta una griglia rettangolare di colori dei caratteri (deve corrispondere alle dimensioni di questo intervallo). I colori sono in notazione CSS (ad esempio '#ffffff' o 'white').

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

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

const cell = sheet.getRange('B5:D6');
cell.setFontColors(colors);

Parametri

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

Indietro

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 (deve corrispondere alle dimensioni di questo intervallo). Esempi di famiglie di caratteri sono "Arial" o "Helvetica".

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

const fonts = [
  ['Arial', 'Helvetica', 'Verdana'],
  ['Courier New', 'Arial', 'Helvetica'],
];

const 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.

Indietro

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".

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

const 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.

Indietro

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 dell'intervallo specificato ('underline', 'line-through' o 'none').

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

const 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.

Indietro

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 (deve corrispondere alle dimensioni di questo intervallo).

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

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

const range = sheet.getRange('B2:D2');
range.setFontLines(fontLines);

Parametri

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

Indietro

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, che corrisponde alla dimensione in punti da utilizzare.

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

const cell = sheet.getRange('B2');
cell.setFontSize(20);

Parametri

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

Indietro

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 dei caratteri (deve corrispondere alle dimensioni di questo intervallo). Le dimensioni sono espresse in punti.

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

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

const range = sheet.getRange('B2:D2');
range.setFontSizes(fontSizes);

Parametri

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

Indietro

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').

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

const 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.

Indietro

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 di carattere (deve corrispondere alle dimensioni di questo intervallo).

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

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

const range = sheet.getRange('B2:C2');
range.setFontStyles(fontStyles);

Parametri

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

Indietro

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).

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

const 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.

Indietro

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 del carattere (deve corrispondere alle dimensioni di questo intervallo). Un esempio di peso del carattere è "grassetto".

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

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

const range = sheet.getRange('B2:D2');
range.setFontWeights(fontStyles);

Parametri

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

Indietro

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 fornita deve essere in notazione A1.

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

const 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.

Indietro

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 fornita deve essere in notazione R1C1.

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

const 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 di stringa.

Indietro

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 (deve corrispondere alle dimensioni di questo intervallo). Le formule fornite devono essere nella notazione A1. Questo metodo accetta un array bidimensionale di formule, indicizzato per riga, quindi per colonna. Le dimensioni dell'array devono corrispondere a quelle dell'intervallo.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const 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.
const formulas = [
  ['=SUM(B2:B4)', '=SUM(C2:C4)', '=SUM(D2:D4)'],
  ['=AVERAGE(B2:B4)', '=AVERAGE(C2:C4)', '=AVERAGE(D2:D4)'],
];

const cell = sheet.getRange('B5:D6');
cell.setFormulas(formulas);

Parametri

Nome	Tipo	Descrizione
`formulas`	`String[][]`	Un array di stringhe bidimensionale di formule.

Indietro

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 (deve corrispondere alle dimensioni di questo intervallo). Le formule fornite devono essere in notazione R1C1.

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

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

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

const 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[][]`	Un array bidimensionale di formule in formato R1C1.

Indietro

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).

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

const 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.

Indietro

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)

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

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

const 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.

Indietro

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.

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

const 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.

Indietro

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 (deve corrispondere alle dimensioni di questo intervallo).

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

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

const 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.

Indietro

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 di numero o data sulla stringa di formattazione specificata. I pattern di formato accettati sono descritti nella documentazione dell'API Sheets.

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

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

Parametri

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

Indietro

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 di numeri o date (deve corrispondere alle dimensioni di questo intervallo). I valori sono stringhe di pattern di formato come descritto nella documentazione dell'API Sheets.

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

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

const range = sheet.getRange('B2:D2');
range.setNumberFormats(formats);

Parametri

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

Indietro

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const richText = SpreadsheetApp.newRichTextValue()
                     .setText('Hello world')
                     .setTextStyle(0, 5, bold)
                     .build();
range.setRichTextValue(richText);

Parametri

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

Indietro

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:A2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const italic = SpreadsheetApp.newTextStyle().setItalic(true).build();
const richTextA1 = SpreadsheetApp.newRichTextValue()
                       .setText('This cell is bold')
                       .setTextStyle(bold)
                       .build();
const 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.

Indietro

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)`

Specifica se l'intervallo deve mostrare 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.

Indietro

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.
const sheet = SpreadsheetApp.getActiveSheet();
const 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.

Indietro

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 poi impostata.

// Copies all of the text directions from range A1:B2 over to range C5:D6.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const 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.

Indietro

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)`

Imposta le impostazioni di rotazione del testo per le celle nell'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 per la direzione da destra a sinistra sono in senso orario.

// Sets all cell's in range B2:D4 to have text rotated up 45 degrees.
const sheet = SpreadsheetApp.getActiveSheet();
const 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 in senso antiorario.

Indietro

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)`

Imposta le impostazioni di rotazione del testo per le celle nell'intervallo.

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

const rotation = sheet.getRange('A1').getTextRotation();

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

Parametri

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

Indietro

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.
const sheet = SpreadsheetApp.getActiveSheet();
const range1 = sheet.getRange('A1:B2');
const range2 = sheet.getRange('C5:D6');

range2.setTextRotations(range1.getTextRotations());

Parametri

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

Indietro

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 del testo per le celle nell'intervallo.

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

Parametri

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

Indietro

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
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B2');
const bold = SpreadsheetApp.newTextStyle().setBold(true).build();
const 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 che preferisci.

Indietro

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.

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

const cell = sheet.getRange('B2');
cell.setValue(100);

Parametri

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

Indietro

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 (deve corrispondere alle dimensioni di questo intervallo). Se un valore inizia con =, viene interpretato come una formula.

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

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

const range = sheet.getRange('B2:D2');
range.setValues(values);

Parametri

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

Indietro

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).

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

const 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.

Indietro

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 (deve corrispondere alle dimensioni di questo intervallo).

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

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

const range = sheet.getRange('B2:D2');
range.setVerticalAlignments(alignments);

Parametri

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

Indietro

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)`

Specifica se impilare o meno il testo per le celle nell'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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('B2:D4');

range.setVerticalText(true);

Parametri

Nome	Tipo	Descrizione
`isVertical`	`Boolean`	Se impilare o meno il testo.

Indietro

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 della cella dell'intervallo specificato.

Le celle con il ritorno a capo attivato (impostazione predefinita) vengono ridimensionate per visualizzare tutti i contenuti. Le celle con il ritorno a capo disattivato mostrano il maggior numero possibile di caratteri nella cella senza ridimensionarla o andare a capo.

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

const cell = sheet.getRange('B2');
cell.setWrap(true);

Parametri

Nome	Tipo	Descrizione
`isWrapEnabled`	`Boolean`	Se il testo deve andare a capo o meno.

Indietro

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 wrapping.

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

range2.setWrapStrategies(range1.getWrapStrategies());

Parametri

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

Indietro

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 ritorno a capo per le celle nell'intervallo.

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

range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parametri

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

Indietro

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)`

Imposta una griglia rettangolare di criteri di ritorno a capo (deve corrispondere alle dimensioni di questo intervallo). Le celle con il ritorno a capo attivato (impostazione predefinita) vengono ridimensionate per visualizzare tutti i contenuti. Le celle con il ritorno a capo disattivato mostrano il maggior numero possibile di caratteri nella cella senza ridimensionarla o andare a capo.

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

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

const range = sheet.getRange('B2:D2');
range.setWraps(wraps);

Parametri

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

Indietro

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à del raggruppamento delle colonne dell'intervallo in base alla quantità specificata.

Ciò ha l'effetto di creare, modificare o eliminare gruppi che si intersecano con l'intervallo. Per i delta positivi, i gruppi vengono creati e/o modificati; per i delta negativi, i gruppi vengono eliminati e/o modificati.

Questa operazione non ha effetto quando si diminuisce la profondità del gruppo al di sotto di zero o al di sopra di otto.

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

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const 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`	L'importo di cui modificare la profondità del gruppo di colonne di questo intervallo.

Indietro

Range: questo intervallo, per il concatenamento.

Lanci

Error: quando tenti di spostare la profondità della prima colonna quando la posizione del 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à del raggruppamento delle righe dell'intervallo in base alla quantità specificata.

Questa operazione non ha effetto quando si diminuisce la profondità del gruppo al di sotto di zero o al di sopra di otto.

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

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const 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`	L'importo di cui modificare la profondità del gruppo di righe di questo intervallo.

Indietro

Range: questo intervallo, per il concatenamento.

Lanci

Error: quando tenti di spostare la profondità della prima riga quando la posizione del 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 in base alla colonna e all'ordine specificati.

const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];
const 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 a cui ordinare.

Indietro

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()`

Divide 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|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns();

// Result after splitting 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)`

Divide 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|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns('#');

// Result after splitting 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 in base al quale eseguire la suddivisione.

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)`

Divide 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|                 |                 |

const range = SpreadsheetApp.getActiveSheet().getRange('A1:A3');
range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON);

// Result after splitting 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 in base al quale eseguire la suddivisione.

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()`

Elimina gli spazi vuoti (come spazi, tabulazioni o nuove righe) in ogni cella di questo intervallo. Rimuove tutti gli spazi vuoti dall'inizio e dalla fine del testo di ogni cella e riduce qualsiasi sequenza di caratteri di spaziatura rimanenti a un singolo spazio.

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('A1:A4');
range.activate();
range.setValues([
  ' preceding space',
  'following space ',
  'two  middle  spaces',
  '   =SUM(1,2)',
]);

range.trimWhitespace();

const values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces',
// '=SUM(1,2)']

Indietro

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 in "non selezionato". Ignora le celle nell'intervallo che attualmente non contengono il valore selezionato o non selezionato configurato.

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

Indietro

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 ritirati

`getFontColor()`

Deprecato. 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').

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

Logger.log(range.getFontColor());

Indietro

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()`

Deprecato. Sostituito da getFontColorObjects()

Restituisce i colori del carattere delle celle nell'intervallo nella notazione CSS (ad esempio '#ffffff' o 'white').

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

const results = range.getFontColors();

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

Indietro

String[][]: un 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

Class Range Mantieni tutto organizzato con le raccolte Salva e classifica i contenuti in base alle tue preferenze.

Metodi

Metodi ritirati

Documentazione dettagliata

activate()

Indietro

activateAsCurrentCell()

Indietro

Autorizzazione

addDeveloperMetadata(key)

Parametri

Indietro

Autorizzazione

addDeveloperMetadata(key, visibility)

Parametri

Indietro

Autorizzazione

addDeveloperMetadata(key, value)

Parametri

Indietro

Autorizzazione

addDeveloperMetadata(key, value, visibility)

Parametri

Indietro

Autorizzazione

applyColumnBanding()

Indietro

Autorizzazione

applyColumnBanding(bandingTheme)

Parametri

Indietro

Autorizzazione

applyColumnBanding(bandingTheme, showHeader, showFooter)

Parametri

Indietro

Autorizzazione

applyRowBanding()

Indietro

Autorizzazione

applyRowBanding(bandingTheme)

Parametri

Indietro

Autorizzazione

applyRowBanding(bandingTheme, showHeader, showFooter)

Parametri

Indietro

Autorizzazione

autoFill(destination, series)

Parametri

Autorizzazione

autoFillToNeighbor(series)

Parametri

Autorizzazione

breakApart()

Indietro

Autorizzazione

canEdit()

Indietro

Autorizzazione

check()

Indietro

Autorizzazione

clear()

Indietro

Autorizzazione

clear(options)

Parametri

Parametri avanzati

Indietro

Autorizzazione

clearContent()

Indietro

Autorizzazione

clearDataValidations()

Indietro

Autorizzazione

clearFormat()

Indietro

Autorizzazione

clearNote()

Class Range

`activate()`

`activateAsCurrentCell()`

`addDeveloperMetadata(key)`

`addDeveloperMetadata(key, visibility)`

`addDeveloperMetadata(key, value)`

`addDeveloperMetadata(key, value, visibility)`

`applyColumnBanding()`

`applyColumnBanding(bandingTheme)`

`applyColumnBanding(bandingTheme, showHeader, showFooter)`

`applyRowBanding()`

`applyRowBanding(bandingTheme)`

`applyRowBanding(bandingTheme, showHeader, showFooter)`

`autoFill(destination, series)`

`autoFillToNeighbor(series)`

`breakApart()`

`canEdit()`

`check()`

`clear()`

`clear(options)`

`clearContent()`

`clearDataValidations()`

`clearFormat()`

`clearNote()`

`collapseGroups()`

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

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

`copyTo(destination)`

`copyTo(destination, copyPasteType, transposed)`

`copyTo(destination, options)`

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

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

`createDataSourcePivotTable(dataSource)`

`createDataSourceTable(dataSource)`

`createDeveloperMetadataFinder()`

`createFilter()`

`createPivotTable(sourceData)`

`createTextFinder(findText)`

`deleteCells(shiftDimension)`

`expandGroups()`

`getA1Notation()`

`getBackground()`

`getBackgroundObject()`

`getBackgroundObjects()`

`getBackgrounds()`