Accedi agli intervalli del foglio di lavoro e modificali. Un intervallo può essere una singola cella di un foglio o un gruppo di celle adiacenti in un foglio.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
activate() | Range | Imposta l'intervallo specificato come active range , con la cella in alto a sinistra nell'intervallo come current cell . |
activateAsCurrentCell() | Range | Imposta la cella specificata come current cell . |
addDeveloperMetadata(key) | Range | Aggiunge all'intervallo i metadati dello sviluppatore con la chiave specificata. |
addDeveloperMetadata(key, visibility) | Range | Aggiunge metadati sviluppatore con la chiave e la visibilità specificate all'intervallo. |
addDeveloperMetadata(key, value) | Range | Aggiunge all'intervallo i metadati dello sviluppatore con la chiave e il valore specificati. |
addDeveloperMetadata(key, value, visibility) | Range | Aggiunge all'intervallo i metadati dello sviluppatore con la chiave, il valore e la visibilità specificati. |
applyColumnBanding() | Banding | Applica all'intervallo un tema predefinito per le bande di colonna. |
applyColumnBanding(bandingTheme) | Banding | Applica all'intervallo un tema specificato per le bande di colonna. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | Applica un tema specificato per le bande di colonna all'intervallo con le impostazioni di intestazione e piè di pagina specificate. |
applyRowBanding() | Banding | Applica all'intervallo un tema predefinito per le bande di riga. |
applyRowBanding(bandingTheme) | Banding | Applica all'intervallo un tema specificato per le bande di riga. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | Applica all'intervallo con impostazioni di intestazione e piè di pagina un tema specificato per le bande di riga. |
autoFill(destination, series) | void | Compila il campo destinationRange con i dati in base ai dati compresi in questo intervallo. |
autoFillToNeighbor(series) | void | Calcola un intervallo per riempire con nuovi dati sulla base di celle vicine e lo riempie automaticamente con nuovi valori in base ai dati contenuti in questo intervallo. |
breakApart() | Range | Suddividi nuovamente le celle a più colonne dell'intervallo in singole celle. |
canEdit() | Boolean | Determina se l'utente è autorizzato a modificare ogni cella dell'intervallo. |
check() | Range | Modifica lo stato delle caselle di controllo nell'intervallo in "Selezionate". |
clear() | Range | Cancella l'intervallo di contenuti e formati. |
clear(options) | Range | Cancella l'intervallo di contenuti, il formato, le regole di convalida dei dati e/o i commenti, come specificato con le opzioni avanzate specificate. |
clearContent() | Range | Cancella i contenuti dell'intervallo, senza modificare la formattazione. |
clearDataValidations() | Range | Cancella le regole di convalida dei dati per l'intervallo. |
clearFormat() | Range | Cancella la formattazione per questo intervallo. |
clearNote() | Range | Cancella la nota nella cella o nelle celle specificate. |
collapseGroups() | Range | Comprime tutti i gruppi che sono interamente contenuti all'interno dell'intervallo. |
copyFormatToRange(gridId, column, columnEnd, row, rowEnd) | void | Copia la formattazione dell'intervallo nella posizione specificata. |
copyFormatToRange(sheet, column, columnEnd, row, rowEnd) | void | Copia la formattazione dell'intervallo nella posizione specificata. |
copyTo(destination) | void | Copia i dati da un intervallo di celle a un altro intervallo di celle. |
copyTo(destination, copyPasteType, transposed) | void | Copia i dati da un intervallo di celle a un altro intervallo di celle. |
copyTo(destination, options) | void | Copia i dati da un intervallo di celle a un altro intervallo di celle. |
copyValuesToRange(gridId, column, columnEnd, row, rowEnd) | void | Copia il contenuto dell'intervallo nella posizione specificata. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | Copia il contenuto dell'intervallo nella posizione specificata. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | Crea una tabella pivot vuota dall'origine dati, ancorata alla prima cella di questo intervallo. |
createDataSourceTable(dataSource) | DataSourceTable | Crea una tabella di origine dati vuota dall'origine dati, ancorata alla prima cella di questo intervallo. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Restituisce un DeveloperMetadataFinderApi per trovare i metadati dello sviluppatore nell'ambito di questo intervallo. |
createFilter() | Filter | Crea un filtro e lo applica all'intervallo specificato sul foglio. |
createPivotTable(sourceData) | PivotTable | Crea una tabella pivot vuota dall'elemento sourceData specificato ancorato alla prima cella di questo intervallo. |
createTextFinder(findText) | TextFinder | Crea una ricerca di testo per l'intervallo, che può trovare e sostituire testo in questo intervallo. |
deleteCells(shiftDimension) | void | Elimina questo intervallo di celle. |
expandGroups() | Range | Espande i gruppi compressi il cui intervallo o il pulsante di attivazione/disattivazione del controllo si interseca con questo intervallo. |
getA1Notation() | String | Restituisce una descrizione stringa dell'intervallo, in notazione A1. |
getBackground() | String | Restituisce il colore di sfondo della cella in alto a sinistra nell'intervallo (ad esempio, '#ffffff' ). |
getBackgroundObject() | Color | Restituisce il colore di sfondo della cella superiore sinistra nell'intervallo. |
getBackgroundObjects() | Color[][] | Restituisce i colori di sfondo delle celle dell'intervallo. |
getBackgrounds() | String[][] | Restituisce i colori di sfondo delle celle dell'intervallo (ad esempio, '#ffffff' ). |
getBandings() | Banding[] | Restituisce tutte le bande applicate a tutte le celle in questo intervallo. |
getCell(row, column) | Range | Restituisce una determinata cella all'interno di un intervallo. |
getColumn() | Integer | Restituisce la posizione iniziale della colonna per questo intervallo. |
getDataRegion() | Range | Restituisce una copia dell'intervallo espanso nei quattro Direction cardinali per coprire tutte le celle adiacenti che contengono dati. |
getDataRegion(dimension) | Range | Restituisce una copia dell'intervallo espanso Direction.UP e Direction.DOWN se la
dimensione specificata è Dimension.ROWS oppure Direction.NEXT e Direction.PREVIOUS se la dimensione è Dimension.COLUMNS . |
getDataSourceFormula() | DataSourceFormula | Restituisce DataSourceFormula per la prima cella dell'intervallo o null se la cella non contiene una formula di origine dati. |
getDataSourceFormulas() | DataSourceFormula[] | Restituisce i DataSourceFormula per le celle nell'intervallo. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Visualizza tutte le tabelle pivot dell'origine dati che si intersecano con l'intervallo. |
getDataSourceTables() | DataSourceTable[] | Visualizza tutte le tabelle dell'origine dati che si intersecano con l'intervallo. |
getDataSourceUrl() | String | Restituisce un URL per i dati in questo intervallo, che può essere utilizzato per creare grafici e query. |
getDataTable() | DataTable | Restituisce i dati all'interno di questo oggetto come una tabella dati. |
getDataTable(firstRowIsHeader) | DataTable | Restituisce i dati all'interno di questo intervallo come una tabella di dati. |
getDataValidation() | DataValidation | Restituisce la regola di convalida dei dati per la cella superiore sinistra dell'intervallo. |
getDataValidations() | DataValidation[][] | Restituisce le regole di convalida dei dati per tutte le celle dell'intervallo. |
getDeveloperMetadata() | DeveloperMetadata[] | Restituisce i metadati dello sviluppatore associati a questo intervallo. |
getDisplayValue() | String | Restituisce il valore visualizzato della cella superiore sinistra dell'intervallo. |
getDisplayValues() | String[][] | Restituisce la griglia rettangolare di valori per questo intervallo. |
getFilter() | Filter | Restituisce il filtro nel foglio a cui appartiene questo intervallo oppure null se non è presente alcun filtro nel foglio. |
getFontColorObject() | Color | Restituisce il colore del carattere della cella nell'angolo superiore sinistro dell'intervallo. |
getFontColorObjects() | Color[][] | Restituisce i colori dei caratteri delle celle dell'intervallo. |
getFontFamilies() | String[][] | Restituisce le famiglie di caratteri delle celle dell'intervallo. |
getFontFamily() | String | Restituisce la famiglia di caratteri della cella nell'angolo superiore sinistro dell'intervallo. |
getFontLine() | String | Restituisce lo stile della riga della cella nell'angolo in alto a sinistra dell'intervallo ('underline' ,
'line-through' o 'none' ). |
getFontLines() | String[][] | Restituisce lo stile della linea delle celle nell'intervallo ('underline' , 'line-through' o 'none' ). |
getFontSize() | Integer | Restituisce la dimensione del carattere in punti della cella nell'angolo superiore sinistro dell'intervallo. |
getFontSizes() | Integer[][] | Restituisce le dimensioni dei caratteri delle celle dell'intervallo. |
getFontStyle() | String | Restituisce lo stile del carattere ('italic' o 'normal' ) della cella nell'angolo in alto a sinistra dell'intervallo. |
getFontStyles() | String[][] | Restituisce gli stili di carattere delle celle dell'intervallo. |
getFontWeight() | String | Restituisce lo spessore del carattere (normale/grassetto) della cella nell'angolo superiore sinistro dell'intervallo. |
getFontWeights() | String[][] | Restituisce lo spessore del carattere delle celle dell'intervallo. |
getFormula() | String | Restituisce la formula (notazione A1) per la cella in alto a sinistra dell'intervallo o una stringa vuota se la cella è vuota o non contiene una formula. |
getFormulaR1C1() | String | Restituisce la formula (notazione R1C1) per una data cella o null se nessuna. |
getFormulas() | String[][] | Restituisce le formule (notazione A1) per le celle dell'intervallo. |
getFormulasR1C1() | String[][] | Restituisce le formule (notazione R1C1) per le celle dell'intervallo. |
getGridId() | Integer | Restituisce l'ID griglia del foglio principale dell'intervallo. |
getHeight() | Integer | Restituisce l'altezza dell'intervallo. |
getHorizontalAlignment() | String | Restituisce l'allineamento orizzontale del testo (sinistra/centro/destra) della cella nell'angolo in alto a sinistra dell'intervallo. |
getHorizontalAlignments() | String[][] | Restituisce gli allineamenti orizzontali delle celle dell'intervallo. |
getLastColumn() | Integer | Restituisce la posizione finale della colonna. |
getLastRow() | Integer | Restituisce la posizione della riga finale. |
getMergedRanges() | Range[] | Restituisce un array di oggetti Range che rappresenta le celle unite che si trovano completamente all'interno dell'intervallo corrente o che contengono almeno una cella nell'intervallo corrente. |
getNextDataCell(direction) | Range | Partendo dalla cella della prima colonna e riga dell'intervallo, restituisce la cella successiva nella direzione data che corrisponde al bordo di un intervallo contiguo di celle contenenti dati al loro interno o alla cella sul bordo del foglio di lavoro in quella direzione. |
getNote() | String | Restituisce la nota associata all'intervallo specificato. |
getNotes() | String[][] | Restituisce le note associate alle celle dell'intervallo. |
getNumColumns() | Integer | Restituisce il numero di colonne in questo intervallo. |
getNumRows() | Integer | Restituisce il numero di righe in questo intervallo. |
getNumberFormat() | String | Visualizza la formattazione del numero o della data della cella in alto a sinistra dell'intervallo specificato. |
getNumberFormats() | String[][] | Restituisce il formato numerico o data per le celle dell'intervallo. |
getRichTextValue() | RichTextValue | Restituisce il valore RTF per la cella superiore sinistra dell'intervallo o null se il valore della cella non è testo. |
getRichTextValues() | RichTextValue[][] | Restituisce i valori RTF per le celle dell'intervallo. |
getRow() | Integer | Restituisce la posizione della riga per questo intervallo. |
getRowIndex() | Integer | Restituisce la posizione della riga per questo intervallo. |
getSheet() | Sheet | Restituisce il foglio a cui appartiene questo intervallo. |
getTextDirection() | TextDirection | Restituisce la direzione del testo della cella superiore sinistra dell'intervallo. |
getTextDirections() | TextDirection[][] | Restituisce le direzioni del testo per le celle dell'intervallo. |
getTextRotation() | TextRotation | Restituisce le impostazioni di rotazione del testo per la cella superiore sinistra dell'intervallo. |
getTextRotations() | TextRotation[][] | Restituisce le impostazioni di rotazione del testo per le celle dell'intervallo. |
getTextStyle() | TextStyle | Restituisce lo stile di testo per la cella superiore sinistra dell'intervallo. |
getTextStyles() | TextStyle[][] | Restituisce gli stili di testo per le celle dell'intervallo. |
getValue() | Object | Restituisce il valore della cella in alto a sinistra nell'intervallo. |
getValues() | Object[][] | Restituisce la griglia rettangolare di valori per questo intervallo. |
getVerticalAlignment() | String | Restituisce l'allineamento verticale (superiore/medio/basso) della cella nell'angolo superiore sinistro dell'intervallo. |
getVerticalAlignments() | String[][] | Restituisce gli allineamenti verticali delle celle dell'intervallo. |
getWidth() | Integer | Restituisce la larghezza dell'intervallo nelle colonne. |
getWrap() | Boolean | Restituisce se il testo nella cella va a capo. |
getWrapStrategies() | WrapStrategy[][] | Restituisce le strategie di testo a capo per le celle dell'intervallo. |
getWrapStrategy() | WrapStrategy | Restituisce la strategia di testo a capo per la cella superiore sinistra dell'intervallo. |
getWraps() | Boolean[][] | Restituisce un valore che indica se il testo nelle celle deve andare a capo. |
insertCells(shiftDimension) | Range | Inserisce celle vuote in questo intervallo. |
insertCheckboxes() | Range | Inserisce le caselle di controllo in ogni cella dell'intervallo, configurata con true per selezionata e false per deselezionata. |
insertCheckboxes(checkedValue) | Range | Inserisce caselle di controllo in ogni cella dell'intervallo, configurata con un valore personalizzato per selezionata e la stringa vuota per deselezionata. |
insertCheckboxes(checkedValue, uncheckedValue) | Range | Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e non selezionati. |
isBlank() | Boolean | Restituisce true se l'intervallo è completamente vuoto. |
isChecked() | Boolean | Indica se la casella di controllo di tutte le celle dell'intervallo è "selezionata". |
isEndColumnBounded() | Boolean | Determina se la fine dell'intervallo è associata a una determinata colonna. |
isEndRowBounded() | Boolean | Determina se la fine dell'intervallo è associata a una determinata riga. |
isPartOfMerge() | Boolean | Restituisce true se le celle nell'intervallo corrente si sovrappongono a eventuali celle unite. |
isStartColumnBounded() | Boolean | Determina se l'inizio dell'intervallo è associato a una determinata colonna. |
isStartRowBounded() | Boolean | Determina se l'inizio dell'intervallo è associato a una determinata riga. |
merge() | Range | Unisce le celle dell'intervallo in un unico blocco. |
mergeAcross() | Range | Unisci le celle dell'intervallo nelle colonne dell'intervallo. |
mergeVertically() | Range | Unisce insieme le celle dell'intervallo. |
moveTo(target) | void | Taglia e incolla (sia il formato che i valori) da questo intervallo all'intervallo target. |
offset(rowOffset, columnOffset) | Range | Restituisce un nuovo intervallo che viene spostato da questo intervallo in base al numero specificato di righe e colonne (che può essere negativo). |
offset(rowOffset, columnOffset, numRows) | Range | Restituisce un nuovo intervallo relativo all'intervallo corrente il cui punto in alto a sinistra è spostato rispetto all'intervallo corrente dalle righe e colonne specificate e con l'altezza specificata nelle celle. |
offset(rowOffset, columnOffset, numRows, numColumns) | Range | Restituisce un nuovo intervallo relativo all'intervallo corrente il cui punto in alto a sinistra è spostato rispetto all'intervallo corrente dalle righe e colonne specificate e con l'altezza e la larghezza specificate nelle celle. |
protect() | Protection | Crea un oggetto in grado di proteggere l'intervallo dalla modifica, se non dagli utenti che dispongono dell'autorizzazione. |
randomize() | Range | Randomizza l'ordine delle righe nell'intervallo specificato. |
removeCheckboxes() | Range | Rimuove tutte le caselle di controllo dall'intervallo. |
removeDuplicates() | Range | Rimuove le righe in questo intervallo che contengono valori che sono duplicati di valori in qualsiasi riga precedente. |
removeDuplicates(columnsToCompare) | Range | Rimuove le righe in questo intervallo che contengono valori nelle colonne specificate che sono duplicati di valori di qualsiasi riga precedente. |
setBackground(color) | Range | Imposta il colore di sfondo di tutte le celle dell'intervallo nella notazione CSS (come '#ffffff'
o 'white' ). |
setBackgroundObject(color) | Range | Imposta il colore di sfondo di tutte le celle dell'intervallo. |
setBackgroundObjects(color) | Range | Imposta una griglia rettangolare di colori di sfondo (devono corrispondere alle dimensioni di questo intervallo). |
setBackgroundRGB(red, green, blue) | Range | Imposta lo sfondo sul colore specificato utilizzando valori RGB (numeri interi compresi tra 0 e 255 inclusi). |
setBackgrounds(color) | Range | Imposta una griglia rettangolare di colori di sfondo (devono corrispondere alle dimensioni di questo intervallo). |
setBorder(top, left, bottom, right, vertical, horizontal) | Range | Imposta la proprietà del bordo. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | Range | Imposta la proprietà del bordo con colore e/o stile. |
setDataValidation(rule) | Range | Imposta una regola di convalida dei dati per tutte le celle dell'intervallo. |
setDataValidations(rules) | Range | Imposta le regole di convalida dei dati per tutte le celle dell'intervallo. |
setFontColor(color) | Range | Imposta il colore del carattere nella notazione CSS (ad esempio '#ffffff' o 'white' ). |
setFontColorObject(color) | Range | Imposta il colore del carattere dell'intervallo specificato. |
setFontColorObjects(colors) | Range | Consente di impostare una griglia rettangolare di colori dei caratteri (devono corrispondere alle dimensioni di questo intervallo). |
setFontColors(colors) | Range | Consente di impostare una griglia rettangolare di colori dei caratteri (devono corrispondere alle dimensioni di questo intervallo). |
setFontFamilies(fontFamilies) | Range | Imposta una griglia rettangolare di famiglie di caratteri (le dimensioni devono corrispondere a questo intervallo). |
setFontFamily(fontFamily) | Range | Imposta la famiglia di caratteri, ad esempio "Arial" o "Helvetica". |
setFontLine(fontLine) | Range | Imposta lo stile della linea del carattere per l'intervallo specificato ('underline' , 'line-through' o 'none' ). |
setFontLines(fontLines) | Range | Imposta una griglia rettangolare di stili di linea (devono corrispondere alle dimensioni di questo intervallo). |
setFontSize(size) | Range | Imposta la dimensione del carattere, dove la dimensione corrisponde alla dimensione in punti da utilizzare. |
setFontSizes(sizes) | Range | Imposta una griglia rettangolare di dimensioni carattere (devono corrispondere alle dimensioni di questo intervallo). |
setFontStyle(fontStyle) | Range | Imposta lo stile del carattere per l'intervallo specificato ('italic' o 'normal' ). |
setFontStyles(fontStyles) | Range | Imposta una griglia rettangolare di stili dei caratteri (devono corrispondere alle dimensioni di questo intervallo). |
setFontWeight(fontWeight) | Range | Imposta lo spessore del carattere per l'intervallo specificato (normale/grassetto). |
setFontWeights(fontWeights) | Range | Imposta una griglia rettangolare di spessori dei caratteri (devono corrispondere alle dimensioni di questo intervallo). |
setFormula(formula) | Range | Aggiorna la formula per questo intervallo. |
setFormulaR1C1(formula) | Range | Aggiorna la formula per questo intervallo. |
setFormulas(formulas) | Range | Imposta una griglia rettangolare di formule (devono corrispondere alle dimensioni di questo intervallo). |
setFormulasR1C1(formulas) | Range | Imposta una griglia rettangolare di formule (devono corrispondere alle dimensioni di questo intervallo). |
setHorizontalAlignment(alignment) | Range | Imposta l'allineamento orizzontale (da sinistra a destra) per l'intervallo specificato (sinistra/centro/destra). |
setHorizontalAlignments(alignments) | Range | Imposta una griglia rettangolare di allineamenti orizzontali. |
setNote(note) | Range | Imposta la nota sul valore specificato. |
setNotes(notes) | Range | Imposta una griglia rettangolare di note (devono corrispondere alle dimensioni di questo intervallo). |
setNumberFormat(numberFormat) | Range | Imposta il formato numerico o data sulla stringa di formattazione specificata. |
setNumberFormats(numberFormats) | Range | Imposta una griglia rettangolare di formati numerici o di data (devono corrispondere alle dimensioni di questo intervallo). |
setRichTextValue(value) | Range | Imposta il valore RTF per le celle dell'intervallo. |
setRichTextValues(values) | Range | Imposta una griglia rettangolare di valori RTF. |
setShowHyperlink(showHyperlink) | Range | Consente di impostare se l'intervallo deve mostrare o meno i link ipertestuali. |
setTextDirection(direction) | Range | Imposta la direzione del testo per le celle nell'intervallo. |
setTextDirections(directions) | Range | Imposta una griglia rettangolare di direzioni del testo. |
setTextRotation(degrees) | Range | Consente di impostare le impostazioni di rotazione del testo per le celle dell'intervallo. |
setTextRotation(rotation) | Range | Consente di impostare le impostazioni di rotazione del testo per le celle dell'intervallo. |
setTextRotations(rotations) | Range | Imposta una griglia rettangolare di rotazioni del testo. |
setTextStyle(style) | Range | Imposta lo stile di testo per le celle dell'intervallo. |
setTextStyles(styles) | Range | Imposta una griglia rettangolare di stili di testo. |
setValue(value) | Range | Imposta il valore dell'intervallo. |
setValues(values) | Range | Imposta una griglia rettangolare di valori (devono corrispondere alle dimensioni di questo intervallo). |
setVerticalAlignment(alignment) | Range | Imposta l'allineamento verticale (dall'alto verso il basso) per l'intervallo specificato (in alto/al centro/in basso). |
setVerticalAlignments(alignments) | Range | Imposta una griglia rettangolare di allineamenti verticali (devono corrispondere alle dimensioni di questo intervallo). |
setVerticalText(isVertical) | Range | Consente di impostare se sovrapporre o meno il testo per le celle dell'intervallo. |
setWrap(isWrapEnabled) | Range | Imposta il ritorno a capo delle celle dell'intervallo specificato. |
setWrapStrategies(strategies) | Range | Imposta una griglia rettangolare di strategie di aggregazione. |
setWrapStrategy(strategy) | Range | Imposta la strategia di testo a capo per le celle dell'intervallo. |
setWraps(isWrapEnabled) | Range | Consente di impostare una griglia rettangolare di criteri per il ritorno a capo automatico (deve corrispondere alle dimensioni di questo intervallo). |
shiftColumnGroupDepth(delta) | Range | Modifica la profondità di raggruppamento delle colonne dell'intervallo in base al valore specificato. |
shiftRowGroupDepth(delta) | Range | Modifica la profondità di raggruppamento delle righe dell'intervallo in base al valore specificato. |
sort(sortSpecObj) | Range | Ordina le celle nell'intervallo specificato, per colonna e ordine specificati. |
splitTextToColumns() | void | Suddivide una colonna di testo in più colonne in base a un delimitatore rilevato automaticamente. |
splitTextToColumns(delimiter) | void | Suddivide una colonna di testo in più colonne utilizzando la stringa specificata come delimitatore personalizzato. |
splitTextToColumns(delimiter) | void | Suddivide una colonna di testo in più colonne in base al delimitatore specificato. |
trimWhitespace() | Range | Modifica gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella dell'intervallo. |
uncheck() | Range | Modifica lo stato delle caselle di controllo nell'intervallo in "Deselezionata". |
Documentazione dettagliata
activate()
Imposta l'intervallo specificato come active range
, con la cella in alto a sinistra nell'intervallo come current cell
.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:D10'); range.activate(); var selection = sheet.getSelection(); // Current cell: A1 var currentCell = selection.getCurrentCell(); // Active Range: A1:D10 var activeRange = selection.getActiveRange();
Ritorni
Range
: questo intervallo, per il concatenamento.
activateAsCurrentCell()
Imposta la cella specificata come current cell
.
Se la cella specificata è presente in un intervallo esistente, questo diventa l'intervallo attivo con la cella come cella corrente.
Se la cella specificata non è presente in alcun intervallo esistente, la selezione esistente viene rimossa e la cella diventa la cella corrente e l'intervallo attivo.
Nota: il valore Range
specificato deve essere composto da una cella, altrimenti genera un'eccezione.
// Gets the first sheet of the spreadsheet. var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; // Gets the cell B5 and sets it as the active cell. var range = sheet.getRange('B5'); var currentCell = range.activateAsCurrentCell(); // Logs the activated cell. console.log(currentCell.getA1Notation());
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key)
Aggiunge all'intervallo i metadati dello sviluppatore con la chiave specificata.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Adds the key 'NAME' to the developer metadata for row 2. range.addDeveloperMetadata('NAME'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
key | String | La chiave per i nuovi metadati dello sviluppatore. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, visibility)
Aggiunge metadati sviluppatore con la chiave e la visibilità specificate all'intervallo.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the developer metadata visibility to 'DOCUMENT' // for row 2 on Sheet1. range.addDeveloperMetadata('NAME', SpreadsheetApp.DeveloperMetadataVisibility.DOCUMENT); // Gets the updated metadata info and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getVisibility().toString());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
key | String | La chiave per i nuovi metadati dello sviluppatore. |
visibility | DeveloperMetadataVisibility | La visibilità dei nuovi metadati dello sviluppatore. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value)
Aggiunge all'intervallo i metadati dello sviluppatore con la chiave e il valore specificati.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 of Sheet1. const range = sheet.getRange('2:2'); // Adds the key 'NAME' and sets the value to 'GOOGLE' for the metadata of row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Gets the metadata and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
key | String | La chiave per i nuovi metadati dello sviluppatore. |
value | String | Il valore dei nuovi metadati dello sviluppatore. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
addDeveloperMetadata(key, value, visibility)
Aggiunge all'intervallo i metadati dello sviluppatore con la chiave, il valore e la visibilità specificati.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Adds the key 'NAME', sets the value to 'GOOGLE', and sets the visibility // to PROJECT for row 2 on the sheet. range.addDeveloperMetadata( 'NAME', 'GOOGLE', SpreadsheetApp.DeveloperMetadataVisibility.PROJECT); // Gets the updated metadata info and logs it to the console. const developerMetaData = range.getDeveloperMetadata()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
key | String | La chiave per i nuovi metadati dello sviluppatore. |
value | String | Il valore dei nuovi metadati dello sviluppatore. |
visibility | DeveloperMetadataVisibility | La visibilità dei nuovi metadati dello sviluppatore. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding()
Applica all'intervallo un tema predefinito per le bande di colonna. Per impostazione predefinita, la banding ha il colore dell'intestazione, senza il colore del piè di pagina.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies column banding to row 2. const colBanding = range.applyColumnBanding(); // Gets the first banding on the sheet and logs the color of the header column. console.log(sheet.getBandings()[0].getHeaderColumnColorObject().asRgbColor().asHexString()); // Gets the first banding on the sheet and logs the color of the second column. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());
Ritorni
Banding
: la nuova banding.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme)
Applica all'intervallo un tema specificato per le bande di colonna. Per impostazione predefinita, le bande hanno il colore dell'intestazione e del piè di pagina.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies the INDIGO color banding theme to the columns in row 2. const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the first banding on the sheet and logs the color of the second column. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
bandingTheme | BandingTheme | Un tema a colori da applicare alle colonne dell'intervallo. |
Ritorni
Banding
: la nuova banding.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyColumnBanding(bandingTheme, showHeader, showFooter)
Applica un tema specificato per le bande di colonna all'intervallo con le impostazioni di intestazione e piè di pagina specificate.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 12-22 on the sheet. const range = sheet.getRange('12:22'); // Applies the BLUE color banding theme to rows 12-22. // Sets the header visibility to false and the footer visibility to true. const colBanding = range.applyColumnBanding(SpreadsheetApp.BandingTheme.BLUE, false, true); // Gets the banding color and logs it to the console. console.log(sheet.getBandings()[0].getSecondColumnColorObject().asRgbColor().asHexString()); // Gets the header color object and logs it to the console. Returns null because the header // visibility is set to false. console.log(sheet.getBandings()[0].getHeaderColumnColorObject()); // Gets the footer color and logs it to the console. console.log(sheet.getBandings()[0].getFooterColumnColorObject().asRgbColor().asHexString());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
bandingTheme | BandingTheme | Un tema a colori da applicare alle colonne dell'intervallo. |
showHeader | Boolean | Se true , il colore dell'intestazione del tema a bande viene applicato alla prima
colonna. |
showFooter | Boolean | Se true , il colore del piè di pagina del tema con bande viene applicato all'ultima colonna. |
Ritorni
Banding
: la nuova banding.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding()
Applica all'intervallo un tema predefinito per le bande di riga. Per impostazione predefinita, la banding ha il colore dell'intestazione, senza il colore del piè di pagina.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies row banding to rows 1-30. range.applyRowBanding(); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0] .getSecondRowColorObject() .asRgbColor() .asHexString(); // Logs the hex color to console. console.log(secondRowColor);
Ritorni
Banding
: banding.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme)
Applica all'intervallo un tema specificato per le bande di riga. Per impostazione predefinita, la banding ha il colore dell'intestazione, senza il colore del piè di pagina.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding theme to rows 1-30. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO); // Gets the hex color of the second banded row. const secondRowColor = range.getBandings()[0] .getSecondRowColorObject() .asRgbColor() .asHexString(); // Logs the hex color to console. console.log(secondRowColor);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
bandingTheme | BandingTheme | Un tema a colori da applicare alle righe nell'intervallo. |
Ritorni
Banding
: la nuova banding.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme, showHeader, showFooter)
Applica all'intervallo con impostazioni di intestazione e piè di pagina un tema specificato per le bande di riga.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding to rows 1-30 and // specifies to hide the header and show the footer. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
bandingTheme | BandingTheme | Un tema a colori da applicare alle righe nell'intervallo. |
showHeader | Boolean | Se true , alla prima riga viene applicato il colore dell'intestazione del tema a bande. |
showFooter | Boolean | Se true , il colore del piè di pagina del tema a bande viene applicato all'ultima riga. |
Ritorni
Banding
: la nuova banding.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFill(destination, series)
Compila il campo destinationRange
con i dati in base ai dati compresi in questo intervallo. I nuovi valori
sono inoltre determinati dal tipo series
specificato. L'intervallo di destinazione deve contenere questo intervallo ed estenderlo in una sola direzione. Ad esempio, quanto segue riempie A1:A20
con una serie di numeri crescenti basati sui valori correnti in A1:A4
:
var sheet = SpreadsheetApp.getActiveSheet(); // Has values [1, 2, 3, 4]. var sourceRange = sheet.getRange("A1:A4"); // The range to fill with values. var destination = sheet.getRange("A1:A20"); // Inserts new values in A5:A20, continuing the pattern expressed in A1:A4 sourceRange.autoFill(destination, SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
destination | Range | L'intervallo da compilare automaticamente con i valori. L'intervallo di destinazione deve contenere questo intervallo ed estenderlo in una sola direzione (verso l'alto, verso il basso, verso sinistra o verso destra). |
series | AutoFillSeries | Il tipo di serie autoFill da utilizzare per calcolare nuovi valori. L'effetto di questa serie varia in base al tipo e alla quantità dei dati di origine. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFillToNeighbor(series)
Calcola un intervallo per riempire con nuovi dati sulla base di celle vicine e lo riempie automaticamente con nuovi valori in base ai dati contenuti in questo intervallo. Questi nuovi valori vengono inoltre
determinati dal tipo series
specificato.
L'intervallo di destinazione calcolato considera i dati circostanti per determinare dove inserire i nuovi valori: se ci sono dati immediatamente a sinistra o a destra di una colonna che viene compilata automaticamente, i nuovi valori si estendono solo fino a questi dati adiacenti.
Ad esempio, se A1:A20
viene compilato con una serie di numeri crescenti e questo metodo viene richiamato nell'intervallo B1:B4
che contiene una serie di date, i nuovi valori vengono inseriti solo in B5:B20
. In questo modo, questi nuovi valori si "attengono" alle celle che contengono i valori nella colonna A.
var sheet = SpreadsheetApp.getActiveSheet(); // A1:A20 has values [1, 2, 3, ... 20]. // B1:B4 has values [1/1/2017, 1/2/2017, ...] var sourceRange = sheet.getRange("B1:B4"); // Results in B5:B20 having values [1/5/2017, ... 1/20/2017] sourceRange.autoFillToNeighbor(SpreadsheetApp.AutoFillSeries.DEFAULT_SERIES);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
series | AutoFillSeries | Il tipo di serie autoFill da utilizzare per calcolare nuovi valori. L'effetto di questa serie varia in base al tipo e alla quantità dei dati di origine. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
Suddividi nuovamente le celle a più colonne dell'intervallo in singole celle.
Chiamare questa funzione in un intervallo equivale a selezionare un intervallo e a fare clic su Formato > Unisci celle > Dividi.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Unmerges the range A1:C6 into individual cells. range.breakApart();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
canEdit()
Determina se l'utente è autorizzato a modificare ogni cella dell'intervallo. Il proprietario del foglio di lavoro è sempre in grado di modificare intervalli e fogli protetti.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6 on Sheet1. const range = sheet.getRange('A1:C6'); // Logs whether the user has permission to edit every cell in the range. console.log(range.canEdit());
Ritorni
Boolean
: true
se l'utente è autorizzato a modificare ogni cella dell'intervallo; in caso contrario false
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
Modifica lo stato delle caselle di controllo nell'intervallo in "Selezionata". Ignora le celle nell'intervallo che attualmente non contengono il valore selezionato o deselezionato configurato.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the range A1:B10 to 'checked'. var range = SpreadsheetApp.getActive().getRange('A1:B10'); range.check();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Cancella l'intervallo di contenuti e formati.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clear();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Cancella l'intervallo di contenuti, il formato, le regole di convalida dei dati e/o i commenti, come specificato con le opzioni avanzate specificate. Per impostazione predefinita, tutti i dati vengono cancellati.
// The code below clears range C2:G7 in the active sheet, but preserves the format, // data validation rules, and comments. SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});
Parametri
Nome | Tipo | Descrizione |
---|---|---|
options | Object | Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
commentsOnly | Boolean | Indica se cancellare solo i commenti. |
contentsOnly | Boolean | Indica se cancellare solo i contenuti. |
formatOnly | Boolean | Indica se cancellare solo il formato. Tieni presente che la cancellazione del formato comporta anche la cancellazione delle regole di convalida dei dati. |
validationsOnly | Boolean | Indica se cancellare solo le regole di convalida dei dati. |
skipFilteredRows | Boolean | Indica se evitare di cancellare le righe filtrate. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
Cancella i contenuti dell'intervallo, senza modificare la formattazione.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearContent();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
Cancella le regole di convalida dei dati per l'intervallo.
// Clear the data validation rules for cells A1:B5. var range = SpreadsheetApp.getActive().getRange('A1:B5'); range.clearDataValidations();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
Cancella la formattazione per questo intervallo.
In questo modo viene cancellata la formattazione del testo della cella o delle celle nell'intervallo, ma non vengono reimpostate le regole di formattazione dei numeri.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearFormat();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
Cancella la nota nella cella o nelle celle specificate.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearNote();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseGroups()
Comprime tutti i gruppi che sono interamente contenuti all'interno dell'intervallo. Se nessun gruppo è completamente all'interno dell'intervallo, viene compresso il gruppo espanso più profondo che rientra parzialmente nell'intervallo.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are collapsed. range.collapseGroups();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
Copia la formattazione dell'intervallo nella posizione specificata. Se la destinazione è maggiore o minore dell'intervallo di origine, l'origine viene ripetuta o troncata di conseguenza. Tieni presente che questo metodo copia solo la formattazione.
Per una descrizione dettagliata del parametro gridId, consulta getGridId()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var range = source.getRange("B2:D4"); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 1555299895. Note that you can get the gridId // of a sheet by calling sheet.getSheetId() or range.getGridId(). range.copyFormatToRange(1555299895, 4, 6, 4, 6);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
gridId | Integer | L'ID univoco del foglio all'interno del foglio di lavoro, indipendentemente dalla posizione. |
column | Integer | La prima colonna dell'intervallo target. |
columnEnd | Integer | La colonna finale dell'intervallo target. |
row | Integer | La riga iniziale dell'intervallo target. |
rowEnd | Integer | La riga finale dell'intervallo target. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Vedi anche
copyFormatToRange(sheet, column, columnEnd, row, rowEnd)
Copia la formattazione dell'intervallo nella posizione specificata. Se la destinazione è maggiore o minore dell'intervallo di origine, l'origine viene ripetuta o troncata di conseguenza. Tieni presente che questo metodo copia solo la formattazione.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var destination = ss.getSheets()[1]; var range = source.getRange("B2:D4"); // This copies the formatting in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyFormatToRange(destination, 4, 6, 4, 6);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sheet | Sheet | Il foglio di destinazione. |
column | Integer | La prima colonna dell'intervallo target. |
columnEnd | Integer | La colonna finale dell'intervallo target. |
row | Integer | La riga iniziale dell'intervallo target. |
rowEnd | Integer | La riga finale dell'intervallo target. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination)
Copia i dati da un intervallo di celle a un altro intervallo di celle. Vengono copiati entrambi i valori e la formattazione.
// The code below copies the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); var rangeToCopy = sheet.getRange(1, 1, sheet.getMaxRows(), 5); rangeToCopy.copyTo(sheet.getRange(1, 6));
Parametri
Nome | Tipo | Descrizione |
---|---|---|
destination | Range | Un intervallo di destinazione in cui copiare; è pertinente solo la posizione della cella superiore sinistra. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, copyPasteType, transposed)
Copia i dati da un intervallo di celle a un altro intervallo di celle.
// The code below copies only the values of the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange("A:E").copyTo(sheet.getRange("F1"), SpreadsheetApp.CopyPasteType.PASTE_VALUES, false);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
destination | Range | Un intervallo di destinazione in cui copiare; è pertinente solo la posizione della cella superiore sinistra. |
copyPasteType | CopyPasteType | Un tipo che specifica in che modo i contenuti dell'intervallo vengono incollati nella destinazione. |
transposed | Boolean | Indica se l'intervallo deve essere incollato nel suo orientamento trasposto. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, options)
Copia i dati da un intervallo di celle a un altro intervallo di celle. Per impostazione predefinita, vengono copiati sia i valori che la formattazione, ma puoi eseguire l'override utilizzando argomenti avanzati.
// The code below copies only the values of the first 5 columns over to the 6th column. var sheet = SpreadsheetApp.getActiveSheet(); sheet.getRange("A:E").copyTo(sheet.getRange("F1"), {contentsOnly:true});
Parametri
Nome | Tipo | Descrizione |
---|---|---|
destination | Range | Un intervallo di destinazione in cui copiare; è pertinente solo la posizione della cella superiore sinistra. |
options | Object | Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
formatOnly | Boolean | indica che deve essere copiato solo il formato |
contentsOnly | Boolean | indica che devono essere copiati solo i contenuti |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)
Copia il contenuto dell'intervallo nella posizione specificata. Se la destinazione è maggiore o minore dell'intervallo di origine, l'origine viene ripetuta o troncata di conseguenza.
Per una descrizione dettagliata del parametro gridId, consulta getGridId()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var range = source.getRange("B2:D4"); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the sheet with gridId 0 range.copyValuesToRange(0, 4, 6, 4, 6);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
gridId | Integer | L'ID univoco del foglio all'interno del foglio di lavoro, indipendentemente dalla posizione. |
column | Integer | La prima colonna dell'intervallo target. |
columnEnd | Integer | La colonna finale dell'intervallo target. |
row | Integer | La riga iniziale dell'intervallo target. |
rowEnd | Integer | La riga finale dell'intervallo target. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Vedi anche
copyValuesToRange(sheet, column, columnEnd, row, rowEnd)
Copia il contenuto dell'intervallo nella posizione specificata. Se la destinazione è maggiore o minore dell'intervallo di origine, l'origine viene ripetuta o troncata di conseguenza.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var source = ss.getSheets()[0]; var destination = ss.getSheets()[1]; var range = source.getRange("B2:D4"); // This copies the data in B2:D4 in the source sheet to // D4:F6 in the second sheet range.copyValuesToRange(destination, 4, 6, 4, 6);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sheet | Sheet | Il foglio di destinazione. |
column | Integer | La prima colonna dell'intervallo target. |
columnEnd | Integer | La colonna finale dell'intervallo target. |
row | Integer | La riga iniziale dell'intervallo target. |
rowEnd | Integer | La riga finale dell'intervallo target. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourcePivotTable(dataSource)
Crea una tabella pivot vuota dall'origine dati, ancorata alla prima cella di questo intervallo.
Questo esempio mostra come creare e configurare una nuova tabella pivot dell'origine dati.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var anchorCell = spreadsheet.getSheets()[0].getRange('A1'); var dataSource = spreadsheet.getDataSources()[0]; var pivotTable = anchorCell.createDataSourcePivotTable(dataSource); pivotTable.addRowGroup('dataColumnA'); pivotTable.addColumnGroup('dataColumnB'); pivotTable.addPivotValue('dataColumnC', SpreadsheetApp.PivotTableSummarizeFunction.SUM); pivotTable.addFilter('dataColumnA', SpreadsheetApp.newFilterCriteria().whenTextStartsWith('A').build());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
dataSource | DataSource | L'origine dati da cui creare la tabella pivot. |
Ritorni
DataSourcePivotTable
: la tabella pivot dell'origine dati appena creata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDataSourceTable(dataSource)
Crea una tabella di origine dati vuota dall'origine dati, ancorata alla prima cella di questo intervallo.
Questo esempio mostra come creare e configurare una nuova tabella di origine dati.
var spreadsheet = SpreadsheetApp.getActiveSpreadsheet(); var anchorCell = spreadsheet.getSheets()[0].getRange('A1'); var dataSource = spreadsheet.getDataSources()[0]; var dataSourceTable = anchorCell.createDataSourceTable(dataSource); .addColumns('dataColumnA', 'dataColumnB', 'dataColumnC') .addSortSpec('dataColumnA', /* ascending= *\/ true) .addSortSpec('dataColumnB', /* ascending= *\/ false);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
dataSource | DataSource | L'origine dati da cui creare la tabella pivot. |
Ritorni
DataSourceTable
: la tabella dell'origine dati appena creata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createDeveloperMetadataFinder()
Restituisce un DeveloperMetadataFinderApi per trovare i metadati dello sviluppatore nell'ambito di questo intervallo. I metadati rientrano nell'ambito dell'intervallo solo se sono interamente contenuti all'interno di quell'intervallo. Ad esempio, i metadati associati alla riga "3:3" non rientrano nell'ambito di un intervallo "A1:D5", ma rientrano nell'ambito di un intervallo "1:5".
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:C6. const range = sheet.getRange('A1:C6'); // Creates a developer metadata finder to search for metadata in the scope of this range. const developerMetaDataFinder = range.createDeveloperMetadataFinder(); // Logs information about the developer metadata finder to the console. const developerMetaData = developerMetaDataFinder.find()[0]; console.log(developerMetaData.getKey()); console.log(developerMetaData.getValue()); console.log(developerMetaData.getVisibility().toString());
Ritorni
DeveloperMetadataFinder
: uno sviluppatore che si occupa di ricerca dei metadati per cercare metadati che rientrano nell'ambito di questo intervallo.
createFilter()
Crea un filtro e lo applica all'intervallo specificato sul foglio. Non puoi creare più di un
filtro in un foglio. Per accedere al filtro e modificarlo dopo averlo creato, utilizza getFilter()
o Sheet.getFilter()
.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Creates a new filter and applies it to the range A1:C20 on the active sheet. function createFilter() { range.createFilter(); } // Gets the filter and applies criteria that only shows cells that aren't empty. function getFilterAddCriteria() { let filter = range.getFilter(); let criteria = SpreadsheetApp.newFilterCriteria() .whenCellNotEmpty() .build(); filter.setColumnFilterCriteria(2, criteria); }Utilizza questo metodo per creare filtri per
Grid
fogli, il tipo predefinito di foglio.
I fogli della griglia sono fogli non connessi a un database. Per creare altri tipi di filtri,
consulta quanto segue:
- Crea un filtro tabella pivot con
PivotTable.addFilter(sourceDataColumn, filterCriteria)
- Crea un filtro per un foglio connesso a un database con
DataSourceSheet.addFilter(columnName, filterCriteria)
- Crea un filtro per una tabella pivot connessa a un database con
DataSourcePivotTable.addFilter(columnName, filterCriteria)
Ritorni
Filter
: il nuovo filtro.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createPivotTable(sourceData)
Crea una tabella pivot vuota dall'elemento sourceData
specificato ancorato alla prima cella di questo intervallo.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A1 as a range in order to place the pivot table. const range = sheet.getRange('A1'); // Gets the range of the source data for the pivot table. const dataRange = sheet.getRange('E12:G20'); // Creates an empty pivot table from the specified source data. const pivotTable = range.createPivotTable(dataRange); // Logs the values from the pivot table's source data to the console. console.log(pivotTable.getSourceDataRange().getValues());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sourceData | Range | I dati da cui creare la tabella pivot. |
Ritorni
PivotTable
: il nuovo PivotTable
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createTextFinder(findText)
Crea una ricerca di testo per l'intervallo, che può trovare e sostituire testo in questo intervallo.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // Creates a text finder for the range. var textFinder = range.createTextFinder('dog'); // Returns the first occurrence of 'dog'. var firstOccurrence = textFinder.findNext(); // Replaces the last found occurrence of 'dog' with 'cat' and returns the number // of occurrences replaced. var numOccurrencesReplaced = textFinder.replaceWith('cat');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
findText | String | Il testo da cercare. |
Ritorni
TextFinder
: il valore TextFinder
per l'intervallo
deleteCells(shiftDimension)
Elimina questo intervallo di celle. I dati esistenti nel foglio lungo la dimensione fornita vengono spostati verso l'intervallo eliminato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.deleteCells(SpreadsheetApp.Dimension.COLUMNS);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
shiftDimension | Dimension | La dimensione in base alla quale spostare i dati esistenti. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandGroups()
Espande i gruppi compressi il cui intervallo o il pulsante di attivazione/disattivazione del controllo si interseca con questo intervallo. La posizione dell'opzione di attivazione/disattivazione del controllo è l'indice in cui viene visualizzata, subito prima o dopo il gruppo, a seconda delle impostazioni. Se c'è più di un gruppo nella stessa località, il gruppo più basso viene espanso.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getA1Notation()
Restituisce una descrizione stringa dell'intervallo, in notazione A1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange(1, 1, 2, 5); // Logs "A1:E2" Logger.log(range.getA1Notation());
Ritorni
String
: la descrizione della stringa dell'intervallo nella notazione A1.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackground()
Restituisce il colore di sfondo della cella in alto a sinistra nell'intervallo (ad esempio, '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackground());
Ritorni
String
: il codice del colore dello sfondo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObject()
Restituisce il colore di sfondo della cella superiore sinistra nell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());
Ritorni
Color
: il colore di sfondo della cella superiore sinistra dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObjects()
Restituisce i colori di sfondo delle celle dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgroundObjects(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j].asRgbColor().asHexString()); } }
Ritorni
Color[][]
: una matrice bidimensionale di colori di sfondo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgrounds()
Restituisce i colori di sfondo delle celle dell'intervallo (ad esempio, '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var bgColors = range.getBackgrounds(); for (var i in bgColors) { for (var j in bgColors[i]) { Logger.log(bgColors[i][j]); } }
Ritorni
String[][]
: array bidimensionale di codici colore degli sfondi.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBandings()
Restituisce tutte le bande applicate a tutte le celle in questo intervallo.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Sets a range. const range = sheet.getRange('A1:K50'); // Gets the banding info for the range. const bandings = range.getBandings(); // Logs the second row color for each banding to the console. for (let banding of bandings) { console.log(banding.getSecondRowColor()); }
Ritorni
Banding[]
: tutte le bande applicate a tutte le celle in questo intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getCell(row, column)
Restituisce una determinata cella all'interno di un intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // The row and column here are relative to the range // getCell(1,1) in this code returns the cell at B2 var cell = range.getCell(1, 1); Logger.log(cell.getValue());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
row | Integer | La riga della cella relativa all'intervallo. |
column | Integer | La colonna della cella relativa all'intervallo. |
Ritorni
Range
: un intervallo contenente una singola cella alle coordinate specificate.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getColumn()
Restituisce la posizione iniziale della colonna per questo intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "2.0" Logger.log(range.getColumn());
Ritorni
Integer
: posizione nella colonna iniziale dell'intervallo nel foglio di lavoro.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion()
Restituisce una copia dell'intervallo espanso nei quattro Direction
cardinali per coprire tutte le celle adiacenti che contengono dati. Se l'intervallo è racchiuso da celle vuote che non includono quelle lungo le diagonali, viene restituito l'intervallo stesso. Questa operazione è simile alla selezione dell'intervallo e
alla digitazione di Ctrl+A
nell'editor.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange("C2").setValue(100); sheet.getRange("B3").setValue(100); sheet.getRange("D3").setValue(100); sheet.getRange("C4").setValue(100); // Logs "B2:D4" Logger.log(sheet.getRange("C3").getDataRegion().getA1Notation());
Ritorni
Range
: la regione di dati dell'intervallo o un intervallo per l'intero foglio di lavoro.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion(dimension)
Restituisce una copia dell'intervallo espanso Direction.UP
e Direction.DOWN
se la
dimensione specificata è Dimension.ROWS
oppure Direction.NEXT
e Direction.PREVIOUS
se la dimensione è Dimension.COLUMNS
. L'espansione dell'intervallo si basa sul rilevamento dei dati accanto all'intervallo organizzato come una tabella. L'intervallo espanso copre tutte le celle adiacenti contenenti dati al loro interno nella dimensione specificata, inclusi i confini della tabella. Se l'intervallo originale è racchiuso da celle vuote lungo la dimensione specificata, viene restituito l'intervallo stesso. Questo metodo è simile alla selezione dell'intervallo e alla digitazione di
Ctrl+Space
per le colonne o di Shift+Space
per le righe nell'editor.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; sheet.getRange("C2").setValue(100); sheet.getRange("B3").setValue(100); sheet.getRange("D3").setValue(100); sheet.getRange("C4").setValue(100); // Logs "C2:C4" Logger.log(sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.ROWS).getA1Notation()); // Logs "B3:D3" Logger.log( sheet.getRange("C3").getDataRegion(SpreadsheetApp.Dimension.COLUMNS).getA1Notation());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
dimension | Dimension | La dimensione in base alla quale espandere l'intervallo. |
Ritorni
Range
: la regione di dati dell'intervallo o un intervallo che copre ogni colonna o ogni riga comprendente
l'intervallo originale.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormula()
Restituisce DataSourceFormula
per la prima cella dell'intervallo o null
se la cella non contiene una formula di origine dati.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1 on Sheet1. const range = sheet.getRange('A1'); // Gets the data source formula from cell A1. const dataSourceFormula = range.getDataSourceFormula(); // Gets the formula. const formula = dataSourceFormula.getFormula(); // Logs the formula. console.log(formula);
Ritorni
DataSourceFormula
: il valore DataSourceFormula
della cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Restituisce i DataSourceFormula
per le celle nell'intervallo.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B5 on Sheet1. const range = sheet.getRange('A1:B5'); // Gets an array of the data source formulas in the range A1:B5. const dataSourceFormulas = range.getDataSourceFormulas(); // Logs the first formula in the array. console.log(dataSourceFormulas[0].getFormula());
Ritorni
DataSourceFormula[]
: un array di DataSourceFormula
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourcePivotTables()
Visualizza tutte le tabelle pivot dell'origine dati che si intersecano con l'intervallo.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets an array of the data source pivot tables in the range A1:G50. const dataSourcePivotTables = range.getDataSourcePivotTables(); // Logs the last time that the first pivot table in the array was refreshed. console.log(dataSourcePivotTables[0].getStatus().getLastRefreshedTime());
Ritorni
DataSourcePivotTable[]
: un elenco di tabelle pivot dell'origine dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceTables()
Visualizza tutte le tabelle dell'origine dati che si intersecano con l'intervallo.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:G50 on Sheet1. const range = sheet.getRange('A1:G50'); // Gets the first data source table in the range A1:G50. const dataSourceTable = range.getDataSourceTables()[0]; // Logs the time of the last completed data execution on the data source table. console.log(dataSourceTable.getStatus().getLastExecutionTime());
Ritorni
DataSourceTable[]
: un elenco di tabelle di origini dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceUrl()
Restituisce un URL per i dati in questo intervallo, che può essere utilizzato per creare grafici e query.
Code.gs
function doGet() { var ss = SpreadsheetApp.openById('1khO6hBWTNNyvyyxvob7aoZTI9ZvlqqASNeq0e29Tw2c'); var sheet = ss.getSheetByName('ContinentData'); var range = sheet.getRange('A1:B8'); var template = HtmlService.createTemplateFromFile('piechart'); template.dataSourceUrl = range.getDataSourceUrl(); return template.evaluate(); }
piechart.html
<!DOCTYPE html> <html> <head> <!--Load the AJAX API--> <script type="text/javascript" src="https://www.gstatic.com/charts/loader.js"></script> <script type="text/javascript"> // Load the Visualization API and the corechart package. google.charts.load('current', {'packages': ['corechart']}); // Set a callback to run when the Google Visualization API is loaded. google.charts.setOnLoadCallback(queryData); function queryData() { var query = new google.visualization.Query('<?= dataSourceUrl ?>'); query.send(drawChart); } // Callback that creates and populates a data table, // instantiates the pie chart, passes in the data and // draws it. function drawChart(response) { if (response.isError()) { alert('Error: ' + response.getMessage() + ' ' + response.getDetailedMessage()); return; } var data = response.getDataTable(); // Set chart options. var options = { title: 'Population by Continent', width: 400, height: 300 }; // Instantiate and draw the chart, passing in some options. var chart = new google.visualization.PieChart(document.getElementById('chart_div')); chart.draw(data, options); } </script> </head> <body> <!-- Div that holds the pie chart. --> <div id="chart_div"></div> </body> </html>
Ritorni
String
: un URL per questo intervallo come origine dati che può essere trasmesso ad altre API, ad esempio i grafici.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataTable()
Restituisce i dati all'interno di questo oggetto come una tabella dati.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B7 on Sheet1. const range = sheet.getRange('A1:B7'); // Gets the range A1:B7 as a data table. The values in each column must be of the same type. const datatable = range.getDataTable(); // Uses the Charts service to build a bar chart from the data table. // This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead. const chart = Charts.newBarChart() .setDataTable(datatable) .setOption('title', 'Your Chart Title Here') .build();
Ritorni
DataTable
: i dati sotto forma di tabella di dati.
getDataTable(firstRowIsHeader)
Restituisce i dati all'interno di questo intervallo come una tabella di dati.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B7"); // Calling this method with "true" sets the first line to be the title of the axes var datatable = range.getDataTable(true); // Note that this doesn't build an EmbeddedChart, so you can't just use // Sheet#insertChart(). To do that, use sheet.newChart().addRange() instead. var chart = Charts.newBarChart() .setDataTable(datatable) .setOption("title", "Your Title Here") .build();
Parametri
Nome | Tipo | Descrizione |
---|---|---|
firstRowIsHeader | Boolean | Indica se considerare la prima riga come un'intestazione. |
Ritorni
DataTable
: i dati sotto forma di tabella di dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidation()
Restituisce la regola di convalida dei dati per la cella superiore sinistra dell'intervallo. Se la convalida dei dati non è stata impostata per la cella, questo metodo restituisce null
.
// Log information about the data validation rule for cell A1. var cell = SpreadsheetApp.getActive().getRange('A1'); var rule = cell.getDataValidation(); if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); Logger.log('The data validation rule is %s %s', criteria, args); } else { Logger.log('The cell does not have a data validation rule.') }
Ritorni
DataValidation
: la regola di convalida dei dati per la cella superiore sinistra dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidations()
Restituisce le regole di convalida dei dati per tutte le celle dell'intervallo. Se la convalida dei dati non è stata impostata per una determinata cella, questo metodo restituisce null
per la posizione della cella nell'array.
// Change existing data validation rules that require a date in 2013 to require a date in 2014. var oldDates = [new Date('1/1/2013'), new Date('12/31/2013')]; var newDates = [new Date('1/1/2014'), new Date('12/31/2014')]; var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange(1, 1, sheet.getMaxRows(), sheet.getMaxColumns()); var rules = range.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { var rule = rules[i][j]; if (rule != null) { var criteria = rule.getCriteriaType(); var args = rule.getCriteriaValues(); if (criteria == SpreadsheetApp.DataValidationCriteria.DATE_BETWEEN && args[0].getTime() == oldDates[0].getTime() && args[1].getTime() == oldDates[1].getTime()) { // Create a builder from the existing rule, then change the dates. rules[i][j] = rule.copy().withCriteria(criteria, newDates).build(); } } } } range.setDataValidations(rules);
Ritorni
DataValidation[][]
: un array bidimensionale di regole di convalida dei dati associate alle celle nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Restituisce i metadati dello sviluppatore associati a questo intervallo.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds metadata to row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Logs the metadata to console. for (const metadata of range.getDeveloperMetadata()) { console.log(`${metadata.getKey()}: ${metadata.getValue()}`); }
Ritorni
DeveloperMetadata[]
: i metadati dello sviluppatore associati a questo intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValue()
Restituisce il valore visualizzato della cella superiore sinistra dell'intervallo. Il valore è String
.
Il valore visualizzato tiene conto della formattazione di data, ora e valuta, inclusi i formati applicati automaticamente dalle impostazioni internazionali del foglio di lavoro. Le celle vuote restituiscono
una stringa vuota.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its value to 'Test code.' const cell = sheet.getRange('A30'); cell.setValue('Test code'); // Gets the value and logs it to the console. console.log(cell.getDisplayValue());
Ritorni
String
: il valore visualizzato in questa cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValues()
Restituisce la griglia rettangolare di valori per questo intervallo.
Restituisce un array bidimensionale di valori visualizzati, indicizzati per riga e poi per colonna. I valori sono oggetti String
. Il valore visualizzato tiene conto della formattazione di data, ora e valuta, inclusi i formati applicati automaticamente dalle impostazioni internazionali del foglio di lavoro. Le celle vuote sono rappresentate da una stringa vuota nell'array. Ricorda che, mentre l'indice di un intervallo inizia da 1, 1
, l'array JavaScript viene indicizzato da [0][0]
.
// The code below gets the displayed values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues(); Logger.log(values[0][0]);
Ritorni
String[][]
: array bidimensionale di valori.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Restituisce il filtro nel foglio a cui appartiene questo intervallo oppure null
se non è presente alcun filtro nel foglio.
let ss = SpreadsheetApp.getActiveSheet(); let range = ss.getRange("A1:C20"); // Gets the existing filter on the sheet that the given range belongs to. let filter = range.getFilter();
Ritorni
Filter
: il filtro.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObject()
Restituisce il colore del carattere della cella nell'angolo superiore sinistro dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontColorObject().asRgbColor().asHexString());
Ritorni
Color
: il colore del carattere della cella superiore sinistra dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontColorObjects()
Restituisce i colori dei caratteri delle celle dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontColorObjects(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j].asRgbColor().asHexString()); } }
Ritorni
Color[][]
: array bidimensionale di colori dei caratteri associati alle celle dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamilies()
Restituisce le famiglie di caratteri delle celle dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontFamilies(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Ritorni
String[][]
: array bidimensionale di famiglie di caratteri associate alle celle dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamily()
Restituisce la famiglia di caratteri della cella nell'angolo superiore sinistro dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontFamily());
Ritorni
String
: la famiglia di caratteri della cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLine()
Restituisce lo stile della riga della cella nell'angolo in alto a sinistra dell'intervallo ('underline'
,
'line-through'
o 'none'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontLine());
Ritorni
String
: riga del carattere.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLines()
Restituisce lo stile della linea delle celle nell'intervallo ('underline'
, 'line-through'
o 'none'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontLines(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Ritorni
String[][]
: array bidimensionale di linee di carattere associate alle celle dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSize()
Restituisce la dimensione del carattere in punti della cella nell'angolo superiore sinistro dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontSize());
Ritorni
Integer
: dimensione del carattere in punti.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSizes()
Restituisce le dimensioni dei caratteri delle celle dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontSizes(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Ritorni
Integer[][]
: array bidimensionale di dimensioni dei caratteri del testo associato alle celle dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyle()
Restituisce lo stile del carattere ('italic'
o 'normal'
) della cella nell'angolo in alto a sinistra dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontStyle());
Ritorni
String
: lo stile del carattere del testo nella cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontStyles()
Restituisce gli stili di carattere delle celle dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontStyles(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Ritorni
String[][]
: array bidimensionale di stili di carattere del testo associato alle celle nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeight()
Restituisce lo spessore del carattere (normale/grassetto) della cella nell'angolo superiore sinistro dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontWeight());
Ritorni
String
: lo spessore del carattere del testo nella cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontWeights()
Restituisce lo spessore del carattere delle celle dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getFontWeights(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Ritorni
String[][]
: array bidimensionale di spessori carattere del testo associato alle celle dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormula()
Restituisce la formula (notazione A1) per la cella in alto a sinistra dell'intervallo o una stringa vuota se la cella è vuota o non contiene una formula.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This assumes you have a function in B5 that sums up // B2:B4 var range = sheet.getRange("B5"); // Logs the calculated value and the formula Logger.log("Calculated value: %s Formula: %s", range.getValue(), range.getFormula());
Ritorni
String
: la formula della cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulaR1C1()
Restituisce la formula (notazione R1C1) per una data cella o null
se nessuna.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5"); var formula = range.getFormulaR1C1(); Logger.log(formula);
Ritorni
String
: la formula nella notazione R1C1.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulas()
Restituisce le formule (notazione A1) per le celle dell'intervallo. Le voci nell'array 2D sono stringhe vuote per le celle senza formula.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formulas = range.getFormulas(); for (var i in formulas) { for (var j in formulas[i]) { Logger.log(formulas[i][j]); } }
Ritorni
String[][]
: matrice bidimensionale di formule in formato stringa.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFormulasR1C1()
Restituisce le formule (notazione R1C1) per le celle dell'intervallo. Le voci nell'array 2D sono null
per le celle senza formula.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formulas = range.getFormulasR1C1(); for (var i in formulas) { for (var j in formulas[i]) { Logger.log(formulas[i][j]); } }
Ritorni
String[][]
: una matrice bidimensionale di formule in notazione R1C1.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getGridId()
Restituisce l'ID griglia del foglio principale dell'intervallo. Gli ID sono valori interi non negativi casuali.
// Log the grid ID of the first sheet (by tab position) in the spreadsheet. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getGridId());
Ritorni
Integer
: l'ID griglia del foglio principale.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHeight()
Restituisce l'altezza dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // logs 3.0 Logger.log(range.getHeight());
Ritorni
Integer
: l'altezza dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignment()
Restituisce l'allineamento orizzontale del testo (sinistra/centro/destra) della cella nell'angolo in alto a sinistra dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getHorizontalAlignment());
Ritorni
String
: allineamento orizzontale del testo nella cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignments()
Restituisce gli allineamenti orizzontali delle celle dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getHorizontalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Ritorni
String[][]
: un array bidimensionale di allineamenti orizzontali di testo associati alle celle nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastColumn()
Restituisce la posizione finale della colonna.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastColumn());
Ritorni
Integer
: posizione della colonna finale dell'intervallo nel foglio di lavoro.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Restituisce la posizione della riga finale.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastRow());
Ritorni
Integer
: posizione della riga finale dell'intervallo nel foglio di lavoro.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMergedRanges()
Restituisce un array di oggetti Range
che rappresenta le celle unite che si trovano completamente all'interno dell'intervallo corrente o che contengono almeno una cella nell'intervallo corrente.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B3"); var mergedRanges = range.getMergedRanges(); for (var i = 0; i < mergedRanges.length; i++) { Logger.log(mergedRanges[i].getA1Notation()); Logger.log(mergedRanges[i].getDisplayValue()); }
Ritorni
Range[]
: un array di oggetti Range
, che rappresenta le celle unite che si sovrappongono all'intervallo.
getNextDataCell(direction)
Partendo dalla cella della prima colonna e riga dell'intervallo, restituisce la cella successiva nella direzione data che corrisponde al bordo di un intervallo contiguo di celle contenenti dati al loro interno o alla cella sul bordo del foglio di lavoro in quella direzione. Equivale a digitare
Ctrl+[arrow key]
nell'editor.
// Assume the active spreadsheet is blank. var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("C3:E5"); // Logs "C1" Logger.log(range.getNextDataCell(SpreadsheetApp.Direction.UP).getA1Notation());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
direction | Direction | La direzione in cui trovare la cella perimetrale della regione di dati successiva. |
Ritorni
Range
: la cella sul bordo della regione di dati o la cella sul bordo del foglio di lavoro.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNote()
Restituisce la nota associata all'intervallo specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getNote());
Ritorni
String
: la nota associata alla cella specificata.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNotes()
Restituisce le note associate alle celle dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getNotes(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Ritorni
String[][]
: array bidimensionale di note associate alle celle dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumColumns()
Restituisce il numero di colonne in questo intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumColumns());
Ritorni
Integer
: il numero di colonne in questo intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumRows()
Restituisce il numero di righe in questo intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumRows());
Ritorni
Integer
: il numero di righe in questo intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormat()
Visualizza la formattazione del numero o della data della cella in alto a sinistra dell'intervallo specificato. I pattern di formato restituiti sono descritti nella documentazione dell'API Fogli.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("C4"); Logger.log(cell.getNumberFormat());
Ritorni
String
: il formato numerico della cella superiore sinistra dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumberFormats()
Restituisce il formato numerico o data per le celle dell'intervallo. I pattern di formato restituiti sono descritti nella documentazione relativa all'API Fogli.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B5:C6"); var formats = range.getNumberFormats(); for (var i in formats) { for (var j in formats[i]) { Logger.log(formats[i][j]); } }
Ritorni
String[][]
: array bidimensionale di formati numerici.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValue()
Restituisce il valore RTF per la cella superiore sinistra dell'intervallo o null
se il valore della cella non è testo.
// Gets the Rich Text value of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var richText = range.getRichTextValue(); console.log(richText.getText());
Ritorni
RichTextValue
: il valore RTF della cella superiore sinistra dell'intervallo o null
se il valore della cella non è testo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValues()
Restituisce i valori RTF per le celle dell'intervallo.
// Gets the Rich Text values for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var values = range.getRichTextValues(); for (var i = 0; i < values.length; i++) { for (var j = 0; j < values[i].length; j++) { console.log(values[i][j].getText()); } }
Ritorni
RichTextValue[][]
: array bidimensionale di valori RTF.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRow()
Restituisce la posizione della riga per questo intervallo. Identico a getRowIndex().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRow());
Ritorni
Integer
: la posizione della riga dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRowIndex()
Restituisce la posizione della riga per questo intervallo. Identico a getRow().
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2"); Logger.log(range.getRowIndex());
Ritorni
Integer
: la posizione della riga dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Vedi anche
getSheet()
Restituisce il foglio a cui appartiene questo intervallo.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the sheet that the range belongs to. const rangeSheet = range.getSheet(); // Gets the sheet name and logs it to the console. console.log(rangeSheet.getName());
Ritorni
Sheet
: il foglio a cui appartiene questo intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirection()
Restituisce la direzione del testo della cella superiore sinistra dell'intervallo. Restituisce null
se la direzione del testo della cella viene determinata con il rilevamento automatico.
// Get the text direction of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getTextDirection());
Ritorni
TextDirection
: la direzione del testo della cella superiore sinistra nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirections()
Restituisce le direzioni del testo per le celle dell'intervallo. Le voci nell'array 2D sono null
per le celle che utilizzano il rilevamento automatico.
// Get the text directions for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var directions = range.getTextDirections(); for (var i = 0; i < directions.length; i++) { for (var j = 0; j < directions[i].length; j++) { Logger.log(directions[i][j]); } }
Ritorni
TextDirection[][]
: array bidimensionale di direzioni del testo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotation()
Restituisce le impostazioni di rotazione del testo per la cella superiore sinistra dell'intervallo.
// Log the text rotation settings for a cell. var sheet = SpreadsheetApp.getActiveSheet(); var cell = sheet.getRange("A1"); Logger.log(cell.getTextRotation());
Ritorni
TextRotation
- Le impostazioni di rotazione del testo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextRotations()
Restituisce le impostazioni di rotazione del testo per le celle dell'intervallo.
var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); var results = range.getTextRotations(); for (var i in results) { for (var j in results[i]) { var rotation = results[i][j]; Logger.log("Cell [%s, %s] has text rotation: %v", i, j, rotation); } }
Ritorni
TextRotation[][]
: array bidimensionale di rotazioni del testo associate alle celle nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyle()
Restituisce lo stile di testo per la cella superiore sinistra dell'intervallo.
// Get the text style of cell D4. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("D4:F6"); var style = range.getTextStyle(); Logger.log(style);
Ritorni
TextStyle
: lo stile di testo della cella superiore sinistra dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextStyles()
Restituisce gli stili di testo per le celle dell'intervallo.
// Get the text styles for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var styles = range.getTextStyles(); for (var i = 0; i < styles.length; i++) { for (var j = 0; j < styles[i].length; j++) { Logger.log(styles[i][j]); } }
Ritorni
TextStyle[][]
: array bidimensionale di stili di testo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValue()
Restituisce il valore della cella in alto a sinistra nell'intervallo. Il valore può essere di tipo Number
, Boolean
, Date
o String
a seconda del valore della cella. Le celle vuote restituiscono una stringa vuota.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the value of the top-left cell in the range and logs it to the console. console.log(range.getValue());
Ritorni
Object
: il valore in questa cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValues()
Restituisce la griglia rettangolare di valori per questo intervallo.
Restituisce un array bidimensionale di valori, indicizzati per riga e poi per colonna. I valori possono essere di tipo Number
, Boolean
, Date
o String
, a seconda del valore della cella. Le celle vuote sono rappresentate da una stringa vuota nell'array. Ricorda che, sebbene l'indice di un intervallo inizia da 1, 1
, l'array JavaScript viene indicizzato da [0][0]
.
// The code below gets the values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getValues(); Logger.log(values[0][0]);Nelle app web, il valore
Date
non è un parametro valido. getValues()
non riesce a restituire dati a un'app web se l'intervallo contiene una cella con un valore Date
. Trasforma invece tutti i valori recuperati dal foglio in una primitiva JavaScript supportata come Number
, Boolean
o String
.Ritorni
Object[][]
: array bidimensionale di valori.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignment()
Restituisce l'allineamento verticale (superiore/medio/basso) della cella nell'angolo superiore sinistro dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getVerticalAlignment());
Ritorni
String
: l'allineamento verticale del testo nella cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignments()
Restituisce gli allineamenti verticali delle celle dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { Logger.log(results[i][j]); } }
Ritorni
String[][]
: un array bidimensionale di allineamenti verticali di testo associati alle celle nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWidth()
Restituisce la larghezza dell'intervallo nelle colonne.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Gets the width of the range in number of columns and logs it to the console. console.log(range.getWidth());
Ritorni
Integer
: il numero di colonne nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrap()
Restituisce se il testo nella cella va a capo. Per una strategia di aggregazione più granulare, utilizza getWrapStrategy()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getWrap());
Ritorni
Boolean
: indica se il testo nella cella va a capo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategies()
Restituisce le strategie di testo a capo per le celle dell'intervallo.
// Get the text wrapping strategies for all cells in range B5:C6 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); var strategies = range.getWrapStrategies(); for (var i = 0; i < strategies.length; i++) { for (var j = 0; j < strategies[i].length; j++) { Logger.log(strategies[i][j]); } }
Ritorni
WrapStrategy[][]
: array bidimensionale di strategie di testo a capo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategy()
Restituisce la strategia di testo a capo per la cella superiore sinistra dell'intervallo.
// Get the text wrapping strategy of cell B1. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B1:D4"); Logger.log(range.getWrapStrategy());
Ritorni
WrapStrategy
: la strategia di ritorno a capo automatico della cella in alto a sinistra nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWraps()
Restituisce un valore che indica se il testo nelle celle deve andare a capo. Per una strategia di aggregazione più granulare, utilizza getWrapStrategies()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); var results = range.getVerticalAlignments(); for (var i in results) { for (var j in results[i]) { var isWrapped = results[i][j]; if (isWrapped) { Logger.log("Cell [%s, %s] has wrapped text", i, j); } } }
Ritorni
Boolean[][]
: un array bidimensionale di allineamenti verticali di testo associati alle celle nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCells(shiftDimension)
Inserisce celle vuote in questo intervallo. Le nuove celle mantengono la formattazione presente nelle celle che occupavano in precedenza questo intervallo. I dati esistenti nel foglio lungo la dimensione fornita vengono spostati dall'intervallo inserito.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.insertCells(SpreadsheetApp.Dimension.COLUMNS);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
shiftDimension | Dimension | La dimensione in base alla quale spostare i dati esistenti. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes()
Inserisce le caselle di controllo in ogni cella dell'intervallo, configurata con true
per selezionata e false
per deselezionata. Imposta il valore di tutte le celle dell'intervallo su false
.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'true' for checked // and 'false' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'false'. range.insertCheckboxes();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue)
Inserisce caselle di controllo in ogni cella dell'intervallo, configurata con un valore personalizzato per selezionata e la stringa vuota per deselezionata. Imposta il valore di ogni cella dell'intervallo sulla stringa vuota.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked // and the empty string for unchecked. Also, sets the value of each cell in the range A1:B10 to // the empty string. range.insertCheckboxes('yes');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
checkedValue | Object | Il valore selezionato per la convalida dei dati della casella di controllo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue, uncheckedValue)
Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e non selezionati. Imposta il valore di ogni cella nell'intervallo sul valore personalizzato deselezionato.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes into each cell in the range A1:B10 configured with 'yes' for checked // and 'no' for unchecked. Also, sets the value of each cell in the range A1:B10 to 'no'. range.insertCheckboxes('yes', 'no');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
checkedValue | Object | Il valore selezionato per la convalida dei dati della casella di controllo. |
uncheckedValue | Object | Il valore deselezionato per la convalida dei dati della casella di controllo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isBlank()
Restituisce true
se l'intervallo è completamente vuoto.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.isBlank());
Ritorni
Boolean
: true
se l'intervallo è vuoto; false
in caso contrario.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isChecked()
Indica se la casella di controllo di tutte le celle dell'intervallo è "selezionata". Restituisce null
se alcune celle sono selezionate e le altre deselezionate o se alcune celle non hanno una casella di controllo di convalida dei dati.
var range = SpreadsheetApp.getActive().getRange('A1:A3'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:A3. range.insertCheckboxes('yes', 'no'); var range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Sets the value of isRange1Checked as true as it contains the checked value. var isRange1Checked = range1.isChecked(); var range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('no'); // Sets the value of isRange2Checked as false as it contains the unchecked value. var isRange2Checked = range2.isChecked(); var range3 = SpreadsheetApp.getActive().getRange('A3'); range3.setValue('random'); // Sets the value of isRange3Checked as null, as it contains an invalid checkbox value. var isRange3Checked = range3.isChecked();
Ritorni
Boolean
: true
, se tutte le celle dell'intervallo sono selezionate, false
se tutte le celle dell'intervallo
sono deselezionate o null
se alcune delle celle sono deselezionate o non presentano
la casella di controllo di convalida dei dati.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndColumnBounded()
Determina se la fine dell'intervallo è associata a una determinata colonna. Ad esempio, per gli intervalli A1:B10
o B:B
, associati a colonne alla fine dell'intervallo, questo metodo restituisce true
. Per gli intervalli 3:7
o A1:5
, associati solo a determinate righe alla fine dell'intervallo, questo metodo restituisce false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular column and logs it to the // console. console.log(range.isEndColumnBounded());
Ritorni
Boolean
: true
se la fine dell'intervallo è associata a una determinata colonna; in caso contrario false
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndRowBounded()
Determina se la fine dell'intervallo è associata a una determinata riga. Ad esempio, per gli intervalli A1:B10
o 3:7
, che sono associati alle righe alla fine dell'intervallo, questo metodo restituisce true
; per gli intervalli B:B
o A1:C
, associati solo a colonne specifiche alla fine dell'intervallo, questo metodo restituisce false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the end of the range is bound to a particular row and logs it to the console. console.log(range.isEndRowBounded());
Ritorni
Boolean
: true
se la fine dell'intervallo è associata a una determinata riga; in caso contrario false
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isPartOfMerge()
Restituisce true
se le celle nell'intervallo corrente si sovrappongono a eventuali celle unite.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:B3"); // True if any of the cells in A1:B3 is included in a merge. var isPartOfMerge = range.isPartOfMerge();
Ritorni
Boolean
: true
se l'intervallo si sovrappone a qualsiasi cella unita; in caso contrario, restituisce false
.
isStartColumnBounded()
Determina se l'inizio dell'intervallo è associato a una determinata colonna. Ad esempio, per gli intervalli A1:B10
o B:B
, che sono associati alle colonne all'inizio dell'intervallo, questo metodo restituisce true
; per l'intervallo 3:7
, associato solo a una riga all'inizio dell'intervallo, questo metodo restituisce false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular column and logs it to the // console. console.log(range.isStartColumnBounded());
Ritorni
Boolean
: true
se l'inizio dell'intervallo è associato a una determinata colonna; in caso contrario false
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isStartRowBounded()
Determina se l'inizio dell'intervallo è associato a una determinata riga. Ad esempio, per gli intervalli A1:B10
o 3:7
, associati alle righe all'inizio dell'intervallo, questo metodo restituisce true
. Per l'intervallo B:B
, associato solo a una determinata colonna all'inizio dell'intervallo, questo metodo restituisce false
.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:D10 on Sheet1. const range = sheet.getRange('A1:D10'); // Determines if the start of the range is bound to a particular row and logs it to the // console. console.log(range.isStartRowBounded());
Ritorni
Boolean
: true
se l'inizio dell'intervallo è associato a una determinata riga; in caso contrario false
.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
merge()
Unisce le celle dell'intervallo in un unico blocco.
var sheet = SpreadsheetApp.getActiveSheet(); // The code below 2-dimensionally merges the cells in A1 to B3 sheet.getRange('A1:B3').merge();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeAcross()
Unisci le celle dell'intervallo nelle colonne dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The code below merges cells C5:E5 into one cell var range1 = sheet.getRange("C5:E5"); range1.mergeAcross(); // The code below creates 2 horizontal cells, F5:H5 and F6:H6 var range2 = sheet.getRange("F5:H6"); range2.mergeAcross();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeVertically()
Unisce insieme le celle dell'intervallo.
var sheet = SpreadsheetApp.getActiveSheet(); // The code below vertically merges the cells in A1 to A10 sheet.getRange('A1:A10').mergeVertically(); // The code below creates 3 merged columns: B1 to B10, C1 to C10, and D1 to D10 sheet.getRange('B1:D10').mergeVertically();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
moveTo(target)
Taglia e incolla (sia il formato che i valori) da questo intervallo all'intervallo target.
// The code below moves the first 5 columns over to the 6th column var sheet = SpreadsheetApp.getActiveSheet() sheet.getRange("A1:E").moveTo(sheet.getRange("F1"));
Parametri
Nome | Tipo | Descrizione |
---|---|---|
target | Range | Un intervallo di destinazione in cui copiare questo intervallo; è pertinente solo la posizione della cella in alto a sinistra. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
offset(rowOffset, columnOffset)
Restituisce un nuovo intervallo che viene spostato da questo intervallo in base al numero specificato di righe e colonne (che può essere negativo). Il nuovo intervallo ha le stesse dimensioni dell'intervallo originale.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2 var newCell = cell.offset(1, 1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowOffset | Integer | Il numero di righe in basso rispetto alla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le righe verso l'alto dalla cella in alto a sinistra dell'intervallo. |
columnOffset | Integer | Il numero di colonne a destra dalla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le colonne a sinistra dalla cella in alto a sinistra dell'intervallo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
offset(rowOffset, columnOffset, numRows)
Restituisce un nuovo intervallo relativo all'intervallo corrente il cui punto in alto a sinistra è spostato rispetto all'intervallo corrente dalle righe e colonne specificate e con l'altezza specificata nelle celle.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2:B3 var newRange = cell.offset(1, 1, 2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowOffset | Integer | Il numero di righe in basso rispetto alla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le righe verso l'alto dalla cella in alto a sinistra dell'intervallo. |
columnOffset | Integer | Il numero di colonne a destra dalla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le colonne a sinistra dalla cella in alto a sinistra dell'intervallo. |
numRows | Integer | L'altezza nelle righe del nuovo intervallo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
offset(rowOffset, columnOffset, numRows, numColumns)
Restituisce un nuovo intervallo relativo all'intervallo corrente il cui punto in alto a sinistra è spostato rispetto all'intervallo corrente dalle righe e colonne specificate e con l'altezza e la larghezza specificate nelle celle.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("A1"); // newCell references B2:C3 var newRange = cell.offset(1, 1, 2, 2);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rowOffset | Integer | Il numero di righe in basso rispetto alla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le righe verso l'alto dalla cella in alto a sinistra dell'intervallo. |
columnOffset | Integer | Il numero di colonne a destra dalla cella in alto a sinistra dell'intervallo; i valori negativi rappresentano le colonne a sinistra dalla cella in alto a sinistra dell'intervallo. |
numRows | Integer | L'altezza nelle righe del nuovo intervallo. |
numColumns | Integer | La larghezza in colonne del nuovo intervallo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
protect()
Crea un oggetto in grado di proteggere l'intervallo dalla modifica, se non dagli utenti che dispongono dell'autorizzazione. Finché lo script non modifica effettivamente l'elenco di editor per l'intervallo (chiamando
Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
o impostando un nuovo
valore per Protection.setDomainEdit(editable)
), le autorizzazioni rispecchiano quelle del
foglio di lavoro stesso, il che significa di fatto che l'intervallo non è protetto. Se l'intervallo è già protetto, questo metodo crea un nuovo intervallo protetto che si sovrappone a quello esistente. Se una cella è protetta da più intervalli protetti e uno di questi impedisce a un determinato utente di modificarla, l'utente non potrà modificare la cella.
// Protect range A1:B10, then remove all other users from the list of editors. var ss = SpreadsheetApp.getActive(); var range = ss.getRange('A1:B10'); var protection = range.protect().setDescription('Sample protected range'); // Ensure the current user is an editor before removing others. Otherwise, if the user's edit // permission comes from a group, the script throws an exception upon removing the group. var me = Session.getEffectiveUser(); protection.addEditor(me); protection.removeEditors(protection.getEditors()); if (protection.canDomainEdit()) { protection.setDomainEdit(false); }
Ritorni
Protection
: oggetto che rappresenta le impostazioni di protezione.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
randomize()
Randomizza l'ordine delle righe nell'intervallo specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:C7"); // Randomizes the range range.randomize();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeCheckboxes()
Rimuove tutte le caselle di controllo dall'intervallo. Cancella la convalida dei dati di ogni cella e cancella anche il relativo valore se la cella contiene il valore selezionato o deselezionato.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); var range1 = SpreadsheetApp.getActive().getRange('A1'); range1.setValue('yes'); // Removes the checkbox data validation in cell A1 and clears its value. range1.removeCheckboxes(); var range2 = SpreadsheetApp.getActive().getRange('A2'); range2.setValue('random'); // Removes the checkbox data validation in cell A2 but does not clear its value. range2.removeCheckboxes();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates()
Rimuove le righe in questo intervallo che contengono valori che sono duplicati di valori in qualsiasi riga precedente. Le righe con valori identici ma con lettere maiuscole, formattazione o formule diverse vengono considerate duplicate. Questo metodo rimuove anche le righe duplicate nascoste (ad esempio, a causa di un filtro). I contenuti al di fuori di questo intervallo non vengono rimossi.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B1:D7"); // Remove duplicate rows in the range. range.removeDuplicates();
Ritorni
Range
: l'intervallo risultante dopo la rimozione dei duplicati. La dimensione dell'intervallo viene ridotta di una riga per ogni riga rimossa.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates(columnsToCompare)
Rimuove le righe in questo intervallo che contengono valori nelle colonne specificate che sono duplicati di valori di qualsiasi riga precedente. Le righe con valori identici ma con lettere maiuscole, formattazione o formule diverse vengono considerate duplicate. Questo metodo rimuove anche le righe duplicate nascoste (ad esempio a causa di un filtro). I contenuti al di fuori di questo intervallo non vengono rimossi.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B1:D7"); // Remove rows which have duplicate values in column B. range.removeDuplicates([2]); // Remove rows which have duplicate values in both columns B and D. range.removeDuplicates([2,4]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
columnsToCompare | Integer[] | Le colonne da analizzare per individuare i valori duplicati. Se non vengono fornite colonne, tutte le colonne vengono analizzate per rilevare eventuali duplicati. |
Ritorni
Range
: l'intervallo risultante dopo la rimozione dei duplicati. La dimensione dell'intervallo viene ridotta di una riga per ogni riga rimossa.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackground(color)
Imposta il colore di sfondo di tutte le celle dell'intervallo nella notazione CSS (come '#ffffff'
o 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); range.setBackground("red");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Un codice colore in notazione CSS (come '#ffffff' o 'white' ); un valore null reimposta il colore. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundObject(color)
Imposta il colore di sfondo di tutte le celle dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var bgColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var range = sheet.getRange("B2:D5"); range.setBackgroundObject(bgColor);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | Il colore di sfondo da impostare; il valore null reimposta il colore dello sfondo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundObjects(color)
Imposta una griglia rettangolare di colori di sfondo (devono corrispondere alle dimensioni di questo intervallo).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); var colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4] ]; var cell = sheet.getRange("B5:C6"); cell.setBackgroundObjects(colors);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color[][] | Un array bidimensionale di colori; i valori null reimpostano il colore. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundRGB(red, green, blue)
Imposta lo sfondo sul colore specificato utilizzando valori RGB (numeri interi compresi tra 0 e 255 inclusi).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets the background to white cell.setBackgroundRGB(255, 255, 255); // Sets the background to red cell.setBackgroundRGB(255, 0, 0);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
red | Integer | Il valore rosso in notazione RGB. |
green | Integer | Il valore verde in notazione RGB. |
blue | Integer | Il valore blu in notazione RGB. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgrounds(color)
Imposta una griglia rettangolare di colori di sfondo (devono corrispondere alle dimensioni di questo intervallo). I colori sono in notazione CSS (come '#ffffff'
o 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colors = [ ["red", "white", "blue"], ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents ]; var cell = sheet.getRange("B5:D6"); cell.setBackgrounds(colors);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String[][] | Un array bidimensionale di colori in notazione CSS (come '#ffffff' o 'white' ); i valori null reimpostano il colore. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal)
Imposta la proprietà del bordo. I valori validi sono true
(on), false
(off) e null
(nessuna modifica).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets borders on the top and bottom, but leaves the left and right unchanged cell.setBorder(true, null, true, null, false, false);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
top | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
left | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
bottom | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
right | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
vertical | Boolean | true per i bordi verticali interni, false per nessuno, null per nessuna modifica. |
horizontal | Boolean | true per i bordi orizzontali interni, false per nessuno, null per nessuna modifica. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal, color, style)
Imposta la proprietà del bordo con colore e/o stile. I valori validi sono true
(on), false
(off) e null
(nessuna modifica). Per il colore, utilizza Colore nella notazione CSS (ad esempio '#ffffff'
o 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Sets borders on the top and bottom, but leaves the left and right unchanged // Also sets the color to "red", and the border to "DASHED". cell.setBorder(true, null, true, null, false, false, "red", SpreadsheetApp.BorderStyle.DASHED);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
top | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
left | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
bottom | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
right | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
vertical | Boolean | true per i bordi verticali interni, false per nessuno, null per nessuna modifica. |
horizontal | Boolean | true per i bordi orizzontali interni, false per nessuno, null per nessuna modifica. |
color | String | Un colore nella notazione CSS (ad esempio '#ffffff' o 'white' ), null per il colore predefinito (nero). |
style | BorderStyle | Uno stile per i bordi, null per lo stile predefinito (solido). |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidation(rule)
Imposta una regola di convalida dei dati per tutte le celle dell'intervallo.
// Set the data validation rule for cell A1 to require a value from B1:B10. var cell = SpreadsheetApp.getActive().getRange('A1'); var range = SpreadsheetApp.getActive().getRange('B1:B10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(range).build(); cell.setDataValidation(rule);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rule | DataValidation | La regola di convalida dei dati da impostare o null per rimuovere la convalida dei dati. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setDataValidations(rules)
Imposta le regole di convalida dei dati per tutte le celle dell'intervallo. Questo metodo prende un array bidimensionale di convalide dei dati, indicizzate per riga e poi per colonna. Le dimensioni dell'array devono corrispondere alle dimensioni dell'intervallo.
// Set the data validation rules for Sheet1!A1:B5 to require a value from Sheet2!A1:A10. var destinationRange = SpreadsheetApp.getActive().getSheetByName('Sheet1').getRange('A1:B5'); var sourceRange = SpreadsheetApp.getActive().getSheetByName('Sheet2').getRange('A1:A10'); var rule = SpreadsheetApp.newDataValidation().requireValueInRange(sourceRange).build(); var rules = destinationRange.getDataValidations(); for (var i = 0; i < rules.length; i++) { for (var j = 0; j < rules[i].length; j++) { rules[i][j] = rule; } } destinationRange.setDataValidations(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rules | DataValidation[][] | Un array bidimensionale di regole di convalida dei dati da impostare; i valori null rimuovono la convalida dei dati. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColor(color)
Imposta il colore del carattere nella notazione CSS (ad esempio '#ffffff'
o 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontColor("red");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del carattere nella notazione CSS (come '#ffffff' o 'white' ); un valore null reimposta il colore. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObject(color)
Imposta il colore del carattere dell'intervallo specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var cell = sheet.getRange("B2"); cell.setFontColor(color);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | Il colore del carattere da impostare; un valore null reimposta il colore. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColorObjects(colors)
Consente di impostare una griglia rettangolare di colori dei caratteri (devono corrispondere alle dimensioni di questo intervallo).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colorAccent1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var colorAccent2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var colorAccent3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var colorAccent4 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT4) .build(); var colors = [ [colorAccent1, colorAccent2], [colorAccent3, colorAccent4] ]; var cell = sheet.getRange("B5:C6"); cell.setFontColorObjects(colors);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
colors | Color[][] | Un array bidimensionale di colori; i valori null reimpostano il colore del carattere. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColors(colors)
Consente di impostare una griglia rettangolare di colori dei caratteri (devono corrispondere alle dimensioni di questo intervallo). I colori sono in notazione CSS (come '#ffffff'
o 'white'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var colors = [ ["red", "white", "blue"], ["#FF0000", "#FFFFFF", "#0000FF"] // These are the hex equivalents ]; var cell = sheet.getRange("B5:D6"); cell.setFontColors(colors);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
colors | Object[][] | Un array bidimensionale di colori in notazione CSS (come '#ffffff' o 'white' ); i valori null reimpostano il colore. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamilies(fontFamilies)
Imposta una griglia rettangolare di famiglie di caratteri (le dimensioni devono corrispondere a questo intervallo). Esempi di famiglie di caratteri sono "Fondato su Google" o "H categoria".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var fonts = [ ["Arial", "Helvetica", "Verdana"], ["Courier New", "Arial", "Helvetica] ]; var cell = sheet.getRange("B2:D3"); cell.setFontFamilies(fonts);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontFamilies | Object[][] | Un array bidimensionale di famiglie di caratteri; i valori null reimpostano la famiglia di caratteri. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamily(fontFamily)
Imposta la famiglia di caratteri, ad esempio "Arial" o "Helvetica".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontFamily("Helvetica");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontFamily | String | La famiglia di caratteri da impostare; un valore null reimposta la famiglia di caratteri. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLine(fontLine)
Imposta lo stile della linea del carattere per l'intervallo specificato ('underline'
, 'line-through'
o 'none'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontLine("line-through");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontLine | String | Lo stile della linea del carattere, 'underline' , 'line-through' o 'none' ; un valore null reimposta lo stile della linea del carattere. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLines(fontLines)
Imposta una griglia rettangolare di stili di linea (devono corrispondere alle dimensioni di questo intervallo).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontLines = [ ["underline", "line-through", "none"] ]; var range = sheet.getRange("B2:D2"); range.setFontLines(fontLines);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontLines | Object[][] | Un array bidimensionale di stili di linee dei caratteri ('underline' , 'line-through' o 'none' ); i valori null reimpostano lo stile della linea del carattere. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSize(size)
Imposta la dimensione del carattere, dove la dimensione corrisponde alla dimensione in punti da utilizzare.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontSize(20);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
size | Integer | La dimensione del carattere in punti. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSizes(sizes)
Imposta una griglia rettangolare di dimensioni carattere (devono corrispondere alle dimensioni di questo intervallo). Le dimensioni sono espresse in punti.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontSizes = [ [16, 20, 24] ]; var range = sheet.getRange("B2:D2"); range.setFontSizes(fontSizes);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sizes | Object[][] | Un array bidimensionale di dimensioni. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyle(fontStyle)
Imposta lo stile del carattere per l'intervallo specificato ('italic'
o 'normal'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontStyle("italic");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontStyle | String | Lo stile del carattere, 'italic' o 'normal' ; un valore null reimposta lo stile del carattere. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyles(fontStyles)
Imposta una griglia rettangolare di stili dei caratteri (devono corrispondere alle dimensioni di questo intervallo).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontStyles = [ ["italic", "normal"] ]; var range = sheet.getRange("B2:C2"); range.setFontStyles(fontStyles);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontStyles | Object[][] | Un array bidimensionale di stili dei caratteri, 'italic' o 'normal' ; i valori null reimpostano lo stile del carattere. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeight(fontWeight)
Imposta lo spessore del carattere per l'intervallo specificato (normale/grassetto).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setFontWeight("bold");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontWeight | String | Lo spessore del carattere, 'bold' o 'normal' ; un valore null reimposta lo spessore del carattere. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeights(fontWeights)
Imposta una griglia rettangolare di spessori dei caratteri (devono corrispondere alle dimensioni di questo intervallo). Un esempio di spessore del carattere è il "grassetto".
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var fontStyles = [ [ "bold", "bold", "normal" ] ]; var range = sheet.getRange("B2:D2"); range.setFontWeights(fontStyles);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontWeights | Object[][] | Un array bidimensionale di spessori carattere, 'bold' o 'normal' ; i valori null reimpostano lo spessore del carattere. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
Aggiorna la formula per questo intervallo. La formula specificata deve essere in notazione A1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); cell.setFormula("=SUM(B3:B4)");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
formula | String | Una stringa che rappresenta la formula da impostare per la cella. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulaR1C1(formula)
Aggiorna la formula per questo intervallo. La formula data deve essere in notazione R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); // This sets the formula to be the sum of the 3 rows above B5 cell.setFormulaR1C1("=SUM(R[-3]C[0]:R[-1]C[0])");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
formula | String | Una formula stringa. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulas(formulas)
Imposta una griglia rettangolare di formule (devono corrispondere alle dimensioni di questo intervallo). Le formule date devono essere in notazione A1. Questo metodo prende una matrice bidimensionale di formule, indicizzate per riga e poi per colonna. Le dimensioni dell'array devono corrispondere alle dimensioni dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This sets the formulas to be a row of sums, followed by a row of averages right below. // The size of the two-dimensional array must match the size of the range. var formulas = [ ["=SUM(B2:B4)", "=SUM(C2:C4)", "=SUM(D2:D4)"], ["=AVERAGE(B2:B4)", "=AVERAGE(C2:C4)", "=AVERAGE(D2:D4)"] ]; var cell = sheet.getRange("B5:D6"); cell.setFormulas(formulas);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
formulas | String[][] | Una matrice stringa bidimensionale di formule. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulasR1C1(formulas)
Imposta una griglia rettangolare di formule (devono corrispondere alle dimensioni di questo intervallo). Le formule date devono essere in notazione R1C1.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // This creates formulas for a row of sums, followed by a row of averages. var sumOfRowsAbove = "=SUM(R[-3]C[0]:R[-1]C[0])"; var averageOfRowsAbove = "=AVERAGE(R[-4]C[0]:R[-2]C[0])"; // The size of the two-dimensional array must match the size of the range. var formulas = [ [sumOfRowsAbove, sumOfRowsAbove, sumOfRowsAbove], [averageOfRowsAbove, averageOfRowsAbove, averageOfRowsAbove] ]; var cell = sheet.getRange("B5:D6"); // This sets the formula to be the sum of the 3 rows above B5. cell.setFormulasR1C1(formulas);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
formulas | String[][] | Una matrice bidimensionale di formule in formato R1C1. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignment(alignment)
Imposta l'allineamento orizzontale (da sinistra a destra) per l'intervallo specificato (sinistra/centro/destra).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setHorizontalAlignment("center");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
alignment | String | L'allineamento, 'left' , 'center' o 'normal' ; un valore null reimposta l'allineamento. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignments(alignments)
Imposta una griglia rettangolare di allineamenti orizzontali. Vedi setHorizontalAlignment(alignment)
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var horizontalAlignments = [ [ "left", "right", "center" ] ]; var range = sheet.getRange("B2:D2"); range.setHorizontalAlignments(horizontalAlignments);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
alignments | Object[][] | Un array bidimensionale di allineamenti, 'left' , 'center' o 'normal' ; un valore null reimposta l'allineamento. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Vedi anche
setNote(note)
Imposta la nota sul valore specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setNote("This is a note");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
note | String | Il valore della nota da impostare per l'intervallo; un valore null rimuove la nota. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNotes(notes)
Imposta una griglia rettangolare di note (devono corrispondere alle dimensioni di questo intervallo).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var notes = [ ["it goes", "like this", "the fourth, the fifth"], ["the minor fall", "and the", "major lift"] ]; var cell = sheet.getRange("B2:D3"); cell.setNotes(notes)
Parametri
Nome | Tipo | Descrizione |
---|---|---|
notes | Object[][] | Un array bidimensionale di note; i valori null rimuovono la nota. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Vedi anche
setNumberFormat(numberFormat)
Imposta il formato numerico o data sulla stringa di formattazione specificata. I pattern di formato accettati sono descritti nella documentazione relativa all'API Fogli.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); // Always show 3 decimal points cell.setNumberFormat("0.000");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
numberFormat | String | Una stringa di formato numerico. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNumberFormats(numberFormats)
Imposta una griglia rettangolare di formati numerici o di data (devono corrispondere alle dimensioni di questo intervallo). I valori sono stringhe di formato di pattern, come descritto nella documentazione relativa all'API Fogli.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var formats = [ [ "0.000", "0,000,000", "$0.00" ] ]; var range = sheet.getRange("B2:D2"); range.setNumberFormats(formats);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
numberFormats | Object[][] | Un array bidimensionale di formati numerici. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRichTextValue(value)
Imposta il valore RTF per le celle dell'intervallo.
// Sets all cells in range B2:D4 to have the text "Hello world", with "Hello" bolded. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var richText = SpreadsheetApp.newRichTextValue() .setText("Hello world") .setTextStyle(0, 5, bold) .build(); range.setRichTextValue(richText);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | RichTextValue | Il valore RTF desiderato. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setRichTextValues(values)
Imposta una griglia rettangolare di valori RTF.
// Sets the cells in range A1:A2 to have Rich Text values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:A2"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var italic = SpreadsheetApp.newTextStyle() .setItalic(true) .build(); var richTextA1 = SpreadsheetApp.newRichTextValue() .setText("This cell is bold") .setTextStyle(bold) .build(); var richTextA2 = SpreadsheetApp.newRichTextValue() .setText("bold words, italic words") .setTextStyle(0, 11, bold) .setTextStyle(12, 24, italic) .build(); range.setRichTextValues([[richTextA1], [richTextA2]]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
values | RichTextValue[][] | I valori RTF desiderati. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setShowHyperlink(showHyperlink)
Consente di impostare se l'intervallo deve mostrare o meno i link ipertestuali.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can useSpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets cell A30 and sets its hyperlink value. const range = sheet.getRange('A30'); range.setValue('https://www.example.com'); // Sets cell A30 to show hyperlinks. range.setShowHyperlink(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
showHyperlink | Boolean | Indica se mostrare o meno il link ipertestuale. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirection(direction)
Imposta la direzione del testo per le celle nell'intervallo. Se una direzione specificata è null
,
la direzione viene dedotta e poi impostata.
// Sets right-to-left text direction for the range. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B5:C6"); range.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
direction | TextDirection | La direzione del testo desiderata; se null la direzione viene dedotta prima dell'impostazione. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirections(directions)
Imposta una griglia rettangolare di direzioni del testo. Se una direzione specificata è null
, la direzione viene dedotta e quindi impostata.
// Copies all of the text directions from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setTextRotations(range1.getTextDirections());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
directions | TextDirection[][] | Le direzioni del testo desiderate. Se una direzione specificata è null , viene dedotta prima dell'impostazione. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(degrees)
Consente di impostare le impostazioni di rotazione del testo per le celle dell'intervallo. L'input corrisponde all'angolo tra l'orientamento standard del testo e l'orientamento desiderato. Un input pari a zero indica che il testo è impostato sull'orientamento standard.
Per la direzione del testo da sinistra a destra, gli angoli positivi sono in senso antiorario, mentre da destra a sinistra sono in senso orario.
// Sets all cell's in range B2:D4 to have text rotated up 45 degrees. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setTextRotation(45);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
degrees | Integer | L'angolo desiderato tra l'orientamento standard e quello desiderato. Per il testo da sinistra a destra, gli angoli positivi sono orientati in senso antiorario. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(rotation)
Consente di impostare le impostazioni di rotazione del testo per le celle dell'intervallo.
// Sets all cell's in range B2:D4 to have the same text rotation settings as cell A1. var sheet = SpreadsheetApp.getActiveSheet(); var rotation = sheet.getRange("A1").getTextRotation(); sheet.getRange("B2:D4").setTextRotation(rotation);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rotation | TextRotation | Le impostazioni di rotazione del testo desiderate. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotations(rotations)
Imposta una griglia rettangolare di rotazioni del testo.
// Copies all of the text rotations from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setTextRotations(range1.getTextRotations());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
rotations | TextRotation[][] | Le impostazioni di rotazione del testo desiderate. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextStyle(style)
Imposta lo stile di testo per le celle dell'intervallo.
// Sets the cells in range C5:D6 to have underlined size 15 font. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("C5:D6"); var style = SpreadsheetApp.newTextStyle() .setFontSize(15) .setUnderline(true) .build(); range.setTextStyle(style);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
style | TextStyle | Lo stile di testo desiderato. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextStyles(styles)
Imposta una griglia rettangolare di stili di testo.
// Sets text styles for cells in range A1:B2 var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B2"); var bold = SpreadsheetApp.newTextStyle() .setBold(true) .build(); var otherStyle = SpreadsheetApp.newTextStyle() .setBold(true) .setUnderline(true) .setItalic(true) .setForegroundColor("#335522") .setFontSize(44) .build(); range.setTextStyles([[bold, otherStyle], [otherStyle, bold]]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
styles | TextStyle[][] | Gli stili di testo desiderati. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(value)
Imposta il valore dell'intervallo. Il valore può essere numerico, stringa, booleano o data. Se inizia con '='
, viene interpretato come una formula.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setValue(100);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | Object | Il valore dell'intervallo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValues(values)
Imposta una griglia rettangolare di valori (devono corrispondere alle dimensioni di questo intervallo). Se un valore inizia con =
, viene interpretato come una formula.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var values = [ [ "2.000", "1,000,000", "$2.99" ] ]; var range = sheet.getRange("B2:D2"); range.setValues(values);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
values | Object[][] | Un array bidimensionale di valori. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignment(alignment)
Imposta l'allineamento verticale (dall'alto verso il basso) per l'intervallo specificato (in alto/al centro/in basso).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setVerticalAlignment("middle");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
alignment | String | L'allineamento, 'top' , 'middle' o 'bottom' ; un valore null reimposta l'allineamento. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignments(alignments)
Imposta una griglia rettangolare di allineamenti verticali (devono corrispondere alle dimensioni di questo intervallo).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var alignments = [ [ "top", "middle", "bottom" ] ]; var range = sheet.getRange("B2:D2"); range.setVerticalAlignments(alignments);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
alignments | Object[][] | Un array bidimensionale di allineamenti, 'top' , 'middle' o 'bottom' ; un valore null reimposta l'allineamento. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Vedi anche
setVerticalText(isVertical)
Consente di impostare se sovrapporre o meno il testo per le celle dell'intervallo. Se il testo è impilato verticalmente, l'impostazione di rotazione del testo in gradi viene ignorata.
// Sets all cell's in range B2:D4 to have vertically stacked text. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setVerticalText(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
isVertical | Boolean | Indica se sovrapporre o meno il testo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrap(isWrapEnabled)
Imposta il ritorno a capo delle celle dell'intervallo specificato.
Le celle con aggregazione attivata (impostazione predefinita) vengono ridimensionate per visualizzare i relativi contenuti completi. Le celle in cui è stato disattivato il wrapping vengono visualizzate il più possibile nella cella senza ridimensionare o eseguire su più righe.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B2"); cell.setWrap(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
isWrapEnabled | Boolean | Indica se mandare a capo o meno il testo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategies(strategies)
Imposta una griglia rettangolare di strategie di aggregazione.
// Copies all of the wrap strategies from range A1:B2 over to range C5:D6. var sheet = SpreadsheetApp.getActiveSheet(); var range1 = sheet.getRange("A1:B2"); var range2 = sheet.getRange("C5:D6"); range2.setWrapStrategies(range1.getWrapStrategies());
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strategies | WrapStrategy[][] | Le strategie di wrapping desiderate. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategy(strategy)
Imposta la strategia di testo a capo per le celle dell'intervallo.
// Sets all cells in range B2:D4 to use the clip wrap strategy. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("B2:D4"); range.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strategy | WrapStrategy | La strategia di wrapping desiderata. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWraps(isWrapEnabled)
Consente di impostare una griglia rettangolare di criteri per il ritorno a capo automatico (deve corrispondere alle dimensioni di questo intervallo). Le celle in cui è abilitato il wrapping (impostazione predefinita) vengono ridimensionate per visualizzare il contenuto completo. Le celle con wrapping disattivato vengono visualizzate il più possibile nella cella senza ridimensionare o eseguire su più righe.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; // The size of the two-dimensional array must match the size of the range. var wraps = [ [ true, true, false ] ]; var range = sheet.getRange("B2:D2"); range.setWraps(wraps);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
isWrapEnabled | Object[][] | Un array bidimensionale di variabili a capo che determina se mandare a capo il testo in una cella o meno. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Vedi anche
shiftColumnGroupDepth(delta)
Modifica la profondità di raggruppamento delle colonne dell'intervallo in base al valore specificato.
In questo modo vengono creati, modificati o eliminati i gruppi che si intersecano con l'intervallo. Per i delta positivi, vengono creati e/o modificati i gruppi; per i delta negativi, i gruppi vengono eliminati e/o modificati.
Ciò non ha effetto se si riduce la profondità del gruppo sotto lo zero o sopra gli otto.
Se column group control position
è BEFORE
, viene visualizzato un errore quando si cerca di spostare la profondità della prima riga.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // The column grouping depth is increased by 1. range.shiftColumnGroupDepth(1); // The column grouping depth is decreased by 1. range.shiftColumnGroupDepth(-1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
delta | Integer | La quantità in base alla quale modificare la profondità del gruppo di colonne di questo intervallo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Tiri
Error
: quando cerchi di spostare la profondità della prima colonna quando la posizione di controllo è GroupControlTogglePosition.BEFORE
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
shiftRowGroupDepth(delta)
Modifica la profondità di raggruppamento delle righe dell'intervallo in base al valore specificato.
In questo modo vengono creati, modificati o eliminati i gruppi che si intersecano con l'intervallo. Per i delta positivi, vengono creati e/o modificati i gruppi; per i delta negativi, i gruppi vengono eliminati e/o modificati.
Ciò non ha effetto se si riduce la profondità del gruppo sotto lo zero o sopra gli otto.
Se row group control position
è BEFORE
, viene visualizzato un errore quando si cerca di spostare la profondità della prima riga.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // The row grouping depth is increased by 1. range.shiftRowGroupDepth(1); // The row grouping depth is decreased by 1. range.shiftRowGroupDepth(-1);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
delta | Integer | La quantità in base alla quale modificare la profondità del gruppo di righe di questo intervallo. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Tiri
Error
: quando si cerca di spostare la profondità della prima riga quando la posizione di controllo è GroupControlTogglePosition.BEFORE
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(sortSpecObj)
Ordina le celle nell'intervallo specificato, per colonna e ordine specificati.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:C7"); // Sorts by the values in the first column (A) range.sort(1); // Sorts by the values in the second column (B) range.sort(2); // Sorts descending by column B range.sort({column: 2, ascending: false}); // Sorts descending by column B, then ascending by column A // Note the use of an array range.sort([{column: 2, ascending: false}, {column: 1, ascending: true}]); // For rows that are sorted in ascending order, the "ascending" parameter is // optional, and just an integer with the column can be used instead. Note that // in general, keeping the sort specification consistent results in more readable // code. You can express the earlier sort as: range.sort([{column: 2, ascending: false}, 1]); // Alternatively, if you want all columns to be in ascending order, you can use // the following (this makes column 2 ascending) range.sort([2, 1]); // ... which is equivalent to range.sort([{column: 2, ascending: true}, {column: 1, ascending: true}]);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
sortSpecObj | Object | Le colonne in base alle quali ordinare. |
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns()
Suddivide una colonna di testo in più colonne in base a un delimitatore rilevato automaticamente.
// A1:A3 has the following values: // A B C // 1 |one,one,one | | | // 2 |two,two,two | | | // 3 |three,three,three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns(); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns(delimiter)
Suddivide una colonna di testo in più colonne utilizzando la stringa specificata come delimitatore personalizzato.
// A1:A3 has the following values: // A B C // 1 |one#one#one | | | // 2 |two#two#two | | | // 3 |three#three#three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns('#'); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Parametri
Nome | Tipo | Descrizione |
---|---|---|
delimiter | String | Il delimitatore personalizzato su cui suddividere. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
splitTextToColumns(delimiter)
Suddivide una colonna di testo in più colonne in base al delimitatore specificato.
// A1:A3 has the following values: // A B C // 1 |one;one;one | | | // 2 |two;two;two | | | // 3 |three;three;three| | | var range = SpreadsheetApp.getActiveSheet().getRange("A1:A3"); range.splitTextToColumns(SpreadsheetApp.TextToColumnsDelimiter.SEMICOLON); // Result after spliting the text to columns: // A B C // 1 |one |one |one | // 2 |two |two |two | // 3 |three |three |three |
Parametri
Nome | Tipo | Descrizione |
---|---|---|
delimiter | TextToColumnsDelimiter | Il delimitatore preimpostato su cui dividere. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trimWhitespace()
Modifica gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella dell'intervallo. Rimuove gli spazi vuoti all'inizio e alla fine del testo di ogni cella e riduce a un unico spazio eventuali sottosequenze di spazi vuoti rimanenti.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:A4'); range.activate(); range.setValues( [' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)']) range.trimWhitespace(); var values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
uncheck()
Modifica lo stato delle caselle di controllo nell'intervallo su "Deselezionata". Ignora le celle nell'intervallo che attualmente non contengono il valore selezionato o deselezionato configurato.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the range A1:B10 to 'unchecked'. var range = SpreadsheetApp.getActive().getRange('A1:B10'); range.uncheck();
Ritorni
Range
: questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets