Accedere e modificare gli intervalli dei fogli di lavoro. Un intervallo può essere una singola cella in un foglio o un gruppo celle adiacenti di un foglio.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
activate() | Range | Imposta l'intervallo specificato come active range , con il valore superiore
cella di 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 all'intervallo metadati dello sviluppatore con la chiave e la visibilità specificate. |
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 metadati dello sviluppatore con la chiave, il valore e la visibilità specificati. |
applyColumnBanding() | Banding | Applica all'intervallo un tema predefinito a bande delle colonne. |
applyColumnBanding(bandingTheme) | Banding | Applica all'intervallo un tema a bande delle colonne specificato. |
applyColumnBanding(bandingTheme, showHeader, showFooter) | Banding | Applica un tema a bande di colonne specificato all'intervallo con intestazione e piè di pagina specificati impostazioni. |
applyRowBanding() | Banding | Applica all'intervallo un tema predefinito a bande delle righe. |
applyRowBanding(bandingTheme) | Banding | Applica all'intervallo un tema a bande di righe specificato. |
applyRowBanding(bandingTheme, showHeader, showFooter) | Banding | Applica un tema a bande di righe specificato all'intervallo con le impostazioni di intestazione e piè di pagina specificate. |
autoFill(destination, series) | void | Riempie destinationRange con i dati in base ai dati compresi in questo intervallo. |
autoFillToNeighbor(series) | void | Calcola un intervallo da riempire con nuovi dati in base alle celle vicine e riempie automaticamente con nuovi valori basati sui 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 dispone dell'autorizzazione per modificare ogni cella dell'intervallo. |
check() | Range | Modifica lo stato delle caselle di controllo nell'intervallo in "selezionata". |
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 indicate. |
clearContent() | Range | Cancella i contenuti dell'intervallo, lasciando intatta la formattazione. |
clearDataValidations() | Range | Cancella le regole di convalida dei dati per l'intervallo. |
clearFormat() | Range | Cancella la formattazione di questo intervallo. |
clearNote() | Range | Cancella la nota nella cella o nelle celle specificate. |
collapseGroups() | Range | Comprime tutti i gruppi 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 i contenuti dell'intervallo nella località specificata. |
copyValuesToRange(sheet, column, columnEnd, row, rowEnd) | void | Copia i contenuti dell'intervallo nella località specificata. |
createDataSourcePivotTable(dataSource) | DataSourcePivotTable | Crea una tabella pivot vuota dell'origine dati dall'origine dati, ancorata alla prima cella in per questo intervallo. |
createDataSourceTable(dataSource) | DataSourceTable | Crea una tabella di origine dati vuota dall'origine dati, ancorata alla prima cella in questo intervallo. |
createDeveloperMetadataFinder() | DeveloperMetadataFinder | Restituisce uno DeveloperMetadataFinderApi per trovare i metadati dello sviluppatore nell'ambito di questo intervallo. |
createFilter() | Filter | Crea un filtro e lo applica all'intervallo specificato nel foglio. |
createPivotTable(sourceData) | PivotTable | Crea una tabella pivot vuota dal valore sourceData specificato ancorato alla prima cella
incluse in questo intervallo. |
createTextFinder(findText) | TextFinder | Crea un cercatore di testo per l'intervallo, in grado di trovare e sostituire il testo in questo intervallo. |
deleteCells(shiftDimension) | void | Elimina questo intervallo di celle. |
expandGroups() | Range | Espande i gruppi compressi il cui intervallo o pulsante di attivazione/disattivazione 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 superiore sinistra dell'intervallo (ad esempio, '#ffffff' ). |
getBackgroundObject() | Color | Restituisce il colore di sfondo della cella superiore sinistra dell'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 qualsiasi cella in questo intervallo. |
getCell(row, column) | Range | Restituisce una data cella all'interno di un intervallo. |
getColumn() | Integer | Restituisce la posizione iniziale della colonna per l'intervallo. |
getDataRegion() | Range | Restituisce una copia dell'intervallo espanso nei quattro Direction cardinali per coprire tutte
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 o Direction.NEXT e Direction.PREVIOUS se la dimensione è Dimension.COLUMNS . |
getDataSourceFormula() | DataSourceFormula | Restituisce DataSourceFormula per la prima cella dell'intervallo oppure null se
la cella non contiene una formula dell'origine dati. |
getDataSourceFormulas() | DataSourceFormula[] | Restituisce i valori DataSourceFormula per le celle dell'intervallo. |
getDataSourcePivotTables() | DataSourcePivotTable[] | Restituisce tutte le tabelle pivot di origine dati che si intersecano con l'intervallo. |
getDataSourceTables() | DataSourceTable[] | Restituisce tutte le tabelle dell'origine dati che si intersecano con l'intervallo. |
getDataSourceUrl() | String | Restituisce un URL per i dati compresi in questo intervallo, che può essere utilizzato per creare grafici e query. |
getDataTable() | DataTable | Restituisce i dati all'interno di questo oggetto come DataTable. |
getDataTable(firstRowIsHeader) | DataTable | Restituisce i dati all'interno di questo intervallo come DataTable. |
getDataValidation() | DataValidation | Restituisce la regola di convalida dei dati per la cella in alto a sinistra dell'intervallo. |
getDataValidations() | DataValidation[][] | Restituisce le regole di convalida dei dati per tutte le celle dell'intervallo. |
getDeveloperMetadata() | DeveloperMetadata[] | Recupera i metadati dello sviluppatore associati a questo intervallo. |
getDisplayValue() | String | Restituisce il valore visualizzato della cella superiore sinistra dell'intervallo. |
getDisplayValues() | String[][] | Restituisce la griglia rettangolare di valori per questo intervallo. |
getFilter() | Filter | Restituisce il filtro sul foglio a cui appartiene questo intervallo o 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 nell'intervallo. |
getFontFamily() | String | Restituisce la famiglia di caratteri della cella nell'angolo superiore sinistro dell'intervallo. |
getFontLine() | String | Restituisce lo stile della linea della cella nell'angolo superiore sinistro 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 dimensione 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 in alto a sinistra
angolo 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 cella è vuota o non contiene una formula. |
getFormulaR1C1() | String | Restituisce la formula (notazione R1C1) per una determinata 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 (a sinistra/centro/destra) della cella in alto a sinistra angolo 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 Range oggetti che rappresenta celle unite completamente
all'interno dell'intervallo corrente o contenere almeno una cella nell'intervallo corrente. |
getNextDataCell(direction) | Range | Partendo dalla cella nella prima colonna e riga dell'intervallo, restituisce la cella successiva nella una data direzione, ovvero il bordo di un intervallo contiguo di celle contenenti dati o la cella sul bordo del foglio di lavoro in quella direzione. |
getNote() | String | Restituisce la nota associata all'intervallo specificato. |
getNotes() | String[][] | Restituisce le note associate alle celle nell'intervallo. |
getNumColumns() | Integer | Restituisce il numero di colonne in questo intervallo. |
getNumRows() | Integer | Restituisce il numero di righe in questo intervallo. |
getNumberFormat() | String | Recupera il numero o la formattazione della data nella cella superiore sinistra dell'intervallo specificato. |
getNumberFormats() | String[][] | Restituisce i formati di numero o data delle celle dell'intervallo. |
getRichTextValue() | RichTextValue | Restituisce il valore RTF per la cella superiore sinistra dell'intervallo o null se la cella
non è testo. |
getRichTextValues() | RichTextValue[][] | Restituisce i valori RTF delle celle dell'intervallo. |
getRow() | Integer | Restituisce la posizione della riga per questo intervallo. |
getRowIndex() | Integer | Restituisce la posizione della riga per questo intervallo. |
getSheet() | Sheet | Restituisce il foglio a cui appartiene questo intervallo. |
getTextDirection() | TextDirection | Restituisce la direzione del testo per la cella 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 dell'intervallo. |
getValues() | Object[][] | Restituisce la griglia rettangolare di valori per questo intervallo. |
getVerticalAlignment() | String | Restituisce l'allineamento verticale (superiore/centrale/in basso) della cella nell'angolo superiore sinistro della intervallo. |
getVerticalAlignments() | String[][] | Restituisce gli allineamenti verticali delle celle nell'intervallo. |
getWidth() | Integer | Restituisce la larghezza dell'intervallo nelle colonne. |
getWrap() | Boolean | Indica 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[][] | Indica se il testo nelle celle va a capo. |
insertCells(shiftDimension) | Range | Inserisce celle vuote in questo intervallo. |
insertCheckboxes() | Range | Inserisce le caselle di controllo in ogni cella dell'intervallo, configurate con true per le caselle selezionate e
false per deselezionato. |
insertCheckboxes(checkedValue) | Range | Inserisce le caselle di controllo in ogni cella dell'intervallo, configurate con un valore personalizzato per le caselle selezionate e la stringa vuota per deselezionata. |
insertCheckboxes(checkedValue, uncheckedValue) | Range | Inserisce le caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per le caselle selezionate e gli stati non selezionati. |
isBlank() | Boolean | Restituisce true se l'intervallo è completamente vuoto. |
isChecked() | Boolean | Restituisce un valore che indica se tutte le celle nell'intervallo hanno lo stato della casella di controllo "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 celle unite. |
isStartColumnBounded() | Boolean | Determina se l'inizio dell'intervallo è legato 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 le celle nell'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 è spostato rispetto a questo intervallo del numero specificato di righe e colonne (che può essere negativo). |
offset(rowOffset, columnOffset, numRows) | Range | Restituisce un nuovo intervallo relativo all'intervallo corrente, il cui punto in alto a sinistra è Offset dall'intervallo corrente per le righe e le colonne date 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 è Offset dall'intervallo corrente per le righe e le colonne date e con l'altezza e la larghezza specificate celle. |
protect() | Protection | Crea un oggetto in grado di proteggere l'intervallo dalla modifica, tranne che per gli utenti che hanno autorizzazione. |
randomize() | Range | Randomizza l'ordine delle righe nell'intervallo specificato. |
removeCheckboxes() | Range | Rimuove tutte le caselle di controllo dall'intervallo. |
removeDuplicates() | Range | Rimuove le righe all'interno di questo intervallo che contengono valori che sono duplicati di valori in qualsiasi riga precedente. |
removeDuplicates(columnsToCompare) | Range | Rimuove le righe all'interno di questo intervallo che contengono valori duplicati nelle colonne specificate di valori in una qualsiasi riga precedente. |
setBackground(color) | Range | Imposta il colore di sfondo di tutte le celle nell'intervallo nella notazione CSS (ad esempio '#ffffff'
o 'white' ). |
setBackgroundObject(color) | Range | Imposta il colore di sfondo di tutte le celle dell'intervallo. |
setBackgroundObjects(color) | Range | Consente di impostare una griglia rettangolare di colori di sfondo (deve corrispondere alle dimensioni di questo intervallo). |
setBackgroundRGB(red, green, blue) | Range | Imposta lo sfondo sul colore specificato utilizzando valori RGB (numeri interi compresi tra 0 e 255 inclusi). |
setBackgrounds(color) | Range | Consente di impostare una griglia rettangolare di colori di sfondo (deve corrispondere alle dimensioni di questo intervallo). |
setBorder(top, left, bottom, right, vertical, horizontal) | Range | Imposta la proprietà del bordo. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | Range | Imposta la proprietà del bordo con il colore e/o lo 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 (deve corrispondere alle dimensioni di questo intervallo). |
setFontColors(colors) | Range | Consente di impostare una griglia rettangolare di colori dei caratteri (deve corrispondere alle dimensioni di questo intervallo). |
setFontFamilies(fontFamilies) | Range | Consente di impostare una griglia rettangolare di famiglie di caratteri (deve corrispondere alle dimensioni di questo intervallo). |
setFontFamily(fontFamily) | Range | Imposta la famiglia di caratteri, ad esempio "Arial" o "HЧ". |
setFontLine(fontLine) | Range | Imposta lo stile della linea del carattere dell'intervallo specificato ('underline' , 'line-through' o
'none' ). |
setFontLines(fontLines) | Range | Consente di impostare una griglia rettangolare di stili di linea (deve corrispondere alle dimensioni di questo intervallo). |
setFontSize(size) | Range | Imposta la dimensione del carattere, che rappresenta la dimensione in punto da utilizzare. |
setFontSizes(sizes) | Range | Consente di impostare una griglia rettangolare di dimensioni dei caratteri (deve corrispondere alle dimensioni di questo intervallo). |
setFontStyle(fontStyle) | Range | Imposta lo stile del carattere per l'intervallo specificato ('italic' o 'normal' ). |
setFontStyles(fontStyles) | Range | Consente di impostare una griglia rettangolare di stili di carattere (deve corrispondere alle dimensioni di questo intervallo). |
setFontWeight(fontWeight) | Range | Imposta lo spessore del carattere per l'intervallo specificato (normale/grassetto). |
setFontWeights(fontWeights) | Range | Consente di impostare una griglia rettangolare di spessori dei caratteri (deve corrispondere alle dimensioni di questo intervallo). |
setFormula(formula) | Range | Aggiorna la formula per l'intervallo. |
setFormulaR1C1(formula) | Range | Aggiorna la formula per l'intervallo. |
setFormulas(formulas) | Range | Consente di impostare una griglia rettangolare di formule (deve corrispondere alle dimensioni di questo intervallo). |
setFormulasR1C1(formulas) | Range | Consente di impostare una griglia rettangolare di formule (deve corrispondere alle dimensioni di questo intervallo). |
setHorizontalAlignment(alignment) | Range | Imposta l'allineamento orizzontale (da sinistra a destra) per l'intervallo specificato (sinistra/centro/destra). |
setHorizontalAlignments(alignments) | Range | Consente di impostare una griglia rettangolare di allineamenti orizzontali. |
setNote(note) | Range | Imposta la nota sul valore specificato. |
setNotes(notes) | Range | Consente di impostare una griglia rettangolare di note (deve corrispondere alle dimensioni di questo intervallo). |
setNumberFormat(numberFormat) | Range | Imposta il formato del numero o della data sulla stringa di formattazione specificata. |
setNumberFormats(numberFormats) | Range | Consente di impostare una griglia rettangolare di formati numeri o data (deve corrispondere alle dimensioni di questo intervallo). |
setRichTextValue(value) | Range | Imposta il valore RTF per le celle dell'intervallo. |
setRichTextValues(values) | Range | Consente di impostare una griglia rettangolare di valori rich text. |
setShowHyperlink(showHyperlink) | Range | Consente di impostare se l'intervallo deve mostrare o meno i link ipertestuali. |
setTextDirection(direction) | Range | Imposta la direzione del testo delle celle nell'intervallo. |
setTextDirections(directions) | Range | Consente di impostare una griglia rettangolare di direzioni di testo. |
setTextRotation(degrees) | Range | Consente di configurare le impostazioni di rotazione del testo per le celle dell'intervallo. |
setTextRotation(rotation) | Range | Consente di configurare le impostazioni di rotazione del testo per le celle dell'intervallo. |
setTextRotations(rotations) | Range | Consente di impostare una griglia rettangolare di rotazioni del testo. |
setTextStyle(style) | Range | Imposta lo stile di testo per le celle dell'intervallo. |
setTextStyles(styles) | Range | Consente di impostare una griglia rettangolare di stili di testo. |
setValue(value) | Range | Imposta il valore dell'intervallo. |
setValues(values) | Range | Consente di impostare una griglia rettangolare di valori (deve corrispondere alle dimensioni di questo intervallo). |
setVerticalAlignment(alignment) | Range | Imposta l'allineamento verticale (dall'alto verso il basso) per l'intervallo specificato (superiore/centro/basso). |
setVerticalAlignments(alignments) | Range | Consente di impostare una griglia rettangolare di allineamenti verticali (deve corrispondere alle dimensioni di questo intervallo). |
setVerticalText(isVertical) | Range | Consente di stabilire se sovrapporre o meno il testo per le celle dell'intervallo. |
setWrap(isWrapEnabled) | Range | Imposta il wrapping di celle dell'intervallo specificato. |
setWrapStrategies(strategies) | Range | Consente di impostare una griglia rettangolare di strategie di aggregazione. |
setWrapStrategy(strategy) | Range | Imposta la strategia di testo a capo per le celle nell'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à del raggruppamento delle colonne dell'intervallo in base al valore specificato. |
shiftRowGroupDepth(delta) | Range | Modifica la profondità del raggruppamento delle righe dell'intervallo in base al valore specificato. |
sort(sortSpecObj) | Range | Ordina le celle nell'intervallo specificato, in base alla colonna e all'ordine specificato. |
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 | Taglia 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 il valore superiore
cella di 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();
Invio
Range
: intervallo, per il concatenamento.
activateAsCurrentCell()
Imposta la cella specificata come current cell
.
Se la cella specificata è presente in un intervallo esistente, quell'intervallo diventa attivo intervallo con la cella come cella corrente.
Se la cella specificata non è presente in alcun intervallo esistente, la selezione esistente è rimosso 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
.
// 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());
Invio
Range
: 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 sviluppatore. |
Invio
Range
: 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 all'intervallo metadati dello sviluppatore con la chiave e la visibilità 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 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 sviluppatore. |
visibility | DeveloperMetadataVisibility | La visibilità dei nuovi metadati sviluppatore. |
Invio
Range
: 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 sviluppatore. |
value | String | Il valore dei nuovi metadati sviluppatore. |
Invio
Range
: 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 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 sviluppatore. |
value | String | Il valore dei nuovi metadati sviluppatore. |
visibility | DeveloperMetadataVisibility | La visibilità dei nuovi metadati sviluppatore. |
Invio
Range
: 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 a bande delle colonne. Per impostazione predefinita, le bande hanno intestazione e nessuna colore 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());
Invio
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 a bande delle colonne specificato. Per impostazione predefinita, le bande hanno intestazione e nessun colore del piè di pagina.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on the sheet. const range = sheet.getRange('2:2'); // Applies 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 nell'intervallo. |
Invio
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 a bande di colonne specificato all'intervallo con intestazione e piè di pagina specificati impostazioni.
// 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 nell'intervallo. |
showHeader | Boolean | Se true , il colore dell'intestazione del tema a bande viene applicato alla prima
colonna. |
showFooter | Boolean | Se true , il colore del piè di pagina del tema a bande viene applicato all'ultimo elemento
colonna. |
Invio
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 a bande delle righe. Per impostazione predefinita, le bande hanno intestazione e nessuna colore 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);
Invio
Banding
- Le bande.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
applyRowBanding(bandingTheme)
Applica all'intervallo un tema a bande di righe specificato. Per impostazione predefinita, le bande hanno intestazione e nessuna colore 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. |
Invio
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 un tema a bande di righe specificato all'intervallo con le impostazioni di intestazione e piè di pagina specificate.
// Opens the spreadsheet by its URL. If you created your script from within a Google Sheets // spreadsheet, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets rows 1-30 on Sheet1. const range = sheet.getRange('1:30'); // Applies the INDIGO row banding to rows 1-30 and // specifies to hide the header and show the footer. range.applyRowBanding(SpreadsheetApp.BandingTheme.INDIGO, false, true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
bandingTheme | BandingTheme | Un tema a colori da applicare alle righe nell'intervallo. |
showHeader | Boolean | Se true , il colore dell'intestazione del tema a bande viene applicato alla prima riga. |
showFooter | Boolean | Se true , il colore del piè di pagina del tema a bande viene applicato all'ultima riga. |
Invio
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)
Riempie destinationRange
con i dati in base ai dati compresi in questo intervallo. I nuovi valori
sono determinati anche dal tipo series
specificato. L'intervallo di destinazione deve contenere
questo intervallo ed estenderlo in una sola direzione. Ad esempio, quanto segue riempie A1:A20
con una serie di numeri crescenti basati sui valori attuali 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 contengono questo intervallo e lo estendono in una sola direzione (verso l'alto, verso il basso, a sinistra a destra). |
series | AutoFillSeries | Il tipo di serie autoFill da utilizzare per calcolare nuovi valori. La di questa serie varia in base al tipo e alla quantità di dati di origine. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
autoFillToNeighbor(series)
Calcola un intervallo da riempire con nuovi dati in base alle celle vicine e riempie automaticamente
con nuovi valori basati sui dati contenuti in questo intervallo. Questi nuovi valori vengono inoltre
determinato dal tipo di series
specificato.
L'intervallo di destinazione calcolato tiene conto dei dati circostanti per determinare dove il nuovo inserire valori da inserire: se sono presenti dati immediatamente a sinistra o a destra di una colonna essere compilati automaticamente, i nuovi valori si estendono solo fino ai dati adiacenti.
Ad esempio, se A1:A20
viene riempito 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
inserito in B5:B20
. In questo modo, questi nuovi valori alle celle che contengono
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. La di questa serie varia in base al tipo e alla quantità di dati di origine. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
breakApart()
Suddividi nuovamente le celle a più colonne dell'intervallo in singole celle.
Chiamare questa funzione su un intervallo equivale a selezionare un intervallo e fare clic 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();
Invio
Range
: 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 dispone dell'autorizzazione per modificare ogni cella dell'intervallo. Il foglio di lavoro proprietario è 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());
Invio
Boolean
: true
se l'utente dispone dell'autorizzazione per modificare ogni cella dell'intervallo; false
negli altri casi.
Autorizzazione
Gli script che utilizzano questo 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 al momento 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();
Invio
Range
: 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();
Invio
Range
: 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 indicate. Per impostazione predefinita, tutti i dati vengono cancellati.
// The code below clears range C2:G7 in the active sheet, but preserves the format, // data validation rules, and comments. SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 5).clear({contentsOnly: true});
Parametri
Nome | Tipo | Descrizione |
---|---|---|
options | Object | Un oggetto JavaScript che specifica 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 cancella anche le 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. |
Invio
Range
: intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
Cancella i contenuti dell'intervallo, lasciando intatta la formattazione.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearContent();
Invio
Range
: 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();
Invio
Range
: 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 di questo intervallo.
Questa azione cancella la formattazione del testo per la cella o le celle dell'intervallo, ma non la reimposta regole di formattazione dei numeri.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:D10"); range.clearFormat();
Invio
Range
: 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();
Invio
Range
: intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
collapseGroups()
Comprime tutti i gruppi interamente contenuti all'interno dell'intervallo. Se nessun gruppo si trova al suo interno all'intervallo, viene compresso il gruppo espanso più profondo parzialmente all'interno dell'intervallo.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are collapsed. range.collapseGroups();
Invio
Range
: intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyFormatToRange(gridId, column, columnEnd, row, rowEnd)
Copia la formattazione dell'intervallo nella posizione specificata. Se la destinazione è più grande o più piccola rispetto all'intervallo di origine, l'origine viene ripetuta o troncata di conseguenza. Tieni presente che 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 è più grande o più piccola rispetto all'intervallo di origine, l'origine viene ripetuta o troncata di conseguenza. Tieni presente che 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. Sia i valori che la formattazione vengono copiati.
// 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 in alto a sinistra. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyTo(destination, copyPasteType, transposed)
Copia i dati da un intervallo di celle a un altro 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 in alto a sinistra. |
copyPasteType | CopyPasteType | Un tipo che specifica in che modo i contenuti dell'intervallo vengono incollati nel destinazione. |
transposed | Boolean | Indica se l'intervallo deve essere incollato nell'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 visualizzati sia i valori formattazione viene copiata, ma è possibile eseguirne 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 in alto a sinistra. |
options | Object | Un oggetto JavaScript che specifica parametri avanzati, come elencato di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
formatOnly | Boolean | indica che deve essere copiato solo il formato |
contentsOnly | Boolean | indica che devono essere copiati solo i contenuti |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
copyValuesToRange(gridId, column, columnEnd, row, rowEnd)
Copia i contenuti dell'intervallo nella località specificata. Se la destinazione è più grande o più piccola rispetto all'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 i contenuti dell'intervallo nella località specificata. Se la destinazione è più grande o più piccola rispetto all'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 dell'origine dati dall'origine dati, ancorata alla prima cella in per 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. |
Invio
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 in 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. |
Invio
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 uno 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 tale intervallo intervallo. Ad esempio, i metadati associati alla riga "3:3" non rientrano nell'ambito di un intervallo "A1:D5", ma rientra nell'ambito dell'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());
Invio
DeveloperMetadataFinder
: uno strumento di ricerca dei metadati degli sviluppatori per cercare metadati nell'ambito di questo intervallo.
createFilter()
Crea un filtro e lo applica all'intervallo specificato nel foglio. Non puoi creare più di
un filtro su 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 i fogli
Grid
, il tipo predefinito di foglio.
I fogli della griglia sono fogli non collegati a un database. Per creare altri tipi di filtri:
fai riferimento a quanto segue:
- Crea un filtro tabella pivot con
PivotTable.addFilter(sourceDataColumn, filterCriteria)
- Crea un filtro per un foglio collegato a un database con
DataSourceSheet.addFilter(columnName, filterCriteria)
- Crea un filtro per una tabella pivot collegata a un database con
DataSourcePivotTable.addFilter(columnName, filterCriteria)
Invio
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 dal valore sourceData
specificato ancorato alla prima cella
incluse 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'); // 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. |
Invio
PivotTable
: il PivotTable
appena creato.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
createTextFinder(findText)
Crea un cercatore di testo per l'intervallo, in grado di trovare e sostituire il 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. |
Invio
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 nell'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 lungo la quale spostare i dati esistenti. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expandGroups()
Espande i gruppi compressi il cui intervallo o pulsante di attivazione/disattivazione si interseca con questo intervallo. La la posizione di attivazione/disattivazione del controllo è l'indice in cui viene visualizzata l'opzione di attivazione/disattivazione del controllo, subito prima o dopo il gruppo, a seconda delle impostazioni. Se c'è più di un gruppo nella stessa località, il gruppo più basso si espande.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getActiveRange(); // All row and column groups within the range are expanded. range.expandGroups();
Invio
Range
: 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());
Invio
String
: la descrizione della stringa dell'intervallo in notazione A1.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackground()
Restituisce il colore di sfondo della cella superiore sinistra dell'intervallo (ad esempio, '#ffffff'
).
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackground());
Invio
String
: il codice colore dello sfondo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObject()
Restituisce il colore di sfondo della cella superiore sinistra dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("B5"); Logger.log(cell.getBackgroundObject().asRgbColor().asHexString());
Invio
Color
: il colore di sfondo della cella in alto a sinistra dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgroundObjects()
Restituisce i colori di sfondo delle celle 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()); } }
Invio
Color[][]
: un array bidimensionale di colori di sfondo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getBackgrounds()
Restituisce i colori di sfondo delle celle 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]); } }
Invio
String[][]
: un array bidimensionale di codici di 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 qualsiasi cella 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()); }
Invio
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 data 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 rispetto all'intervallo. |
Invio
Range
: un intervallo contenente una singola cella nelle 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 l'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "2.0" Logger.log(range.getColumn());
Invio
Integer
: la posizione della colonna iniziale dell'intervallo nel foglio di lavoro.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataRegion()
Restituisce una copia dell'intervallo espanso nei quattro Direction
cardinali per coprire tutte
celle adiacenti che contengono dati. Se l'intervallo è circondato da celle vuote che non comprendono quelle
lungo le diagonali, viene restituito l'intervallo stesso. È un po' come selezionare l'intervallo
digitando 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());
Invio
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
o 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 con dati al loro interno lungo la dimensione specificata, inclusa la tabella
confini. Se l'intervallo originale è circondato da celle vuote lungo la dimensione specificata,
viene restituito l'intervallo stesso. Questo metodo è simile a selezionare l'intervallo e digitare
Ctrl+Space
per le colonne o 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 lungo la quale espandere l'intervallo. |
Invio
Range
: la regione di dati dell'intervallo o un intervallo che copre ogni colonna o ogni riga comprendeta dalla
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 oppure null
se
la cella non contiene una formula dell'origine dati.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1 on Sheet1. const range = sheet.getRange('A1'); // Gets the data source formula from cell A1. const dataSourceFormula = range.getDataSourceFormula(); // Gets the formula. const formula = dataSourceFormula.getFormula(); // Logs the formula. console.log(formula);
Invio
DataSourceFormula
: DataSourceFormula
per la cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataSourceFormulas()
Restituisce i valori DataSourceFormula
per le celle dell'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());
Invio
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()
Restituisce tutte le tabelle pivot di 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());
Invio
DataSourcePivotTable[]
: un elenco di tabelle pivot 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
getDataSourceTables()
Restituisce 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());
Invio
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 compresi 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>
Invio
String
: un URL per questo intervallo come origine dati che può essere passata ad altre API come i grafici.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataTable()
Restituisce i dati all'interno di questo oggetto come DataTable.
// Opens the spreadsheet file by its ID. If you created your script from a Google Sheets file, // use SpreadsheetApp.getActiveSpreadsheet(). // TODO(developer): Replace the ID with your own. const ss = SpreadsheetApp.openById('abc123456'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets the range A1:B7 on Sheet1. const range = sheet.getRange('A1:B7'); // Gets the range A1:B7 as a data table. The values in each column must be of the same type. const datatable = range.getDataTable(); // Uses the Charts service to build a bar chart from the data table. // This doesn't build an embedded chart. To do that, use sheet.newChart().addRange() instead. const chart = Charts.newBarChart() .setDataTable(datatable) .setOption('title', 'Your Chart Title Here') .build();
Invio
DataTable
: i dati come tabella dati.
getDataTable(firstRowIsHeader)
Restituisce i dati all'interno di questo intervallo come DataTable.
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 trattare la prima riga come un'intestazione. |
Invio
DataTable
: i dati come tabella 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 in alto a sinistra dell'intervallo. Se la convalida dei dati non ha
impostato nella 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.') }
Invio
DataValidation
: la regola di convalida dei dati per la cella in alto a sinistra dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDataValidations()
Restituisce le regole di convalida dei dati per tutte le celle dell'intervallo. Se la convalida dei dati non è stata
impostato su una determinata cella, questo metodo restituisce null
per la posizione di quella 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);
Invio
DataValidation[][]
: un array bidimensionale di regole di convalida dei dati associate alle celle nella
intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDeveloperMetadata()
Recupera i metadati dello sviluppatore associati a questo intervallo.
// Opens the spreadsheet file by its URL. If you created your script from within a // Google Sheets file, you can use SpreadsheetApp.getActiveSpreadsheet() instead. // TODO(developer): Replace the URL with your own. const ss = SpreadsheetApp.openByUrl('https://docs.google.com/spreadsheets/d/abc123456/edit'); // Gets Sheet1 by its name. const sheet = ss.getSheetByName('Sheet1'); // Gets row 2 on Sheet1. const range = sheet.getRange('2:2'); // Adds metadata to row 2. range.addDeveloperMetadata('NAME', 'GOOGLE'); // Logs the metadata to console. for (const metadata of range.getDeveloperMetadata()) { console.log(`${metadata.getKey()}: ${metadata.getValue()}`); }
Invio
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 è un String
.
Il valore visualizzato tiene conto della formattazione di data, ora e valuta, inclusi
applicati automaticamente
in base alle impostazioni internazionali del foglio di lavoro. Le celle vuote restituiscono uno spazio vuoto
stringa.
// 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());
Invio
String
: il valore visualizzato in questa cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDisplayValues()
Restituisce la griglia rettangolare di valori per questo intervallo.
Restituisce una matrice bidimensionale dei valori visualizzati, indicizzati per riga e poi per colonna. La
sono oggetti String
. Il valore visualizzato tiene conto di data, ora e
la formattazione della valuta, inclusi i formati applicati automaticamente dalle impostazioni internazionali del foglio di lavoro
dell'ambientazione. Le celle vuote sono rappresentate da una stringa vuota nell'array. Ricorda che mentre
l'indice dell'intervallo inizia da 1, 1
, l'array JavaScript è indicizzato da [0][0]
.
// The code below gets the displayed values for the range C2:G8 // in the active spreadsheet. Note that this is a JavaScript array. var values = SpreadsheetApp.getActiveSheet().getRange(2, 3, 6, 4).getDisplayValues(); Logger.log(values[0][0]);
Invio
String[][]
: un array di valori bidimensionale.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFilter()
Restituisce il filtro sul foglio a cui appartiene questo intervallo o 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();
Invio
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());
Invio
Color
: il colore del carattere della cella in alto a sinistra dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
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()); } }
Invio
Color[][]
: un array bidimensionale di colori dei caratteri associati alle celle dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontFamilies()
Restituisce le famiglie di caratteri delle celle nell'intervallo.
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]); } }
Invio
String[][]
: un array bidimensionale di famiglie di caratteri 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
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());
Invio
String
: la famiglia di caratteri della cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLine()
Restituisce lo stile della linea della cella nell'angolo superiore sinistro 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());
Invio
String
: la riga del carattere.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontLines()
Restituisce lo stile della linea delle celle nell'intervallo ('underline'
, 'line-through'
o
'none'
).
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]); } }
Invio
String[][]
: un array bidimensionale di linee di caratteri associate alle celle dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getFontSize()
Restituisce la dimensione del carattere in dimensione 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());
Invio
Integer
: la dimensione del carattere in dimensione 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]); } }
Invio
Integer[][]
: un array bidimensionale di dimensioni dei caratteri del testo 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
getFontStyle()
Restituisce lo stile del carattere ('italic'
o 'normal'
) della cella in alto a sinistra
angolo dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getFontStyle());
Invio
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]); } }
Invio
String[][]
: un array bidimensionale di stili di caratteri di testo 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
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());
Invio
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]); } }
Invio
String[][]
: un array bidimensionale di spessore 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
getFormula()
Restituisce la formula (notazione A1) per la cella in alto a sinistra dell'intervallo o una stringa vuota se 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());
Invio
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 determinata 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);
Invio
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]); } }
Invio
String[][]
: una 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]); } }
Invio
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 int casuali non negativi.
// 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());
Invio
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());
Invio
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 (a sinistra/centro/destra) della cella in alto a sinistra angolo dell'intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getHorizontalAlignment());
Invio
String
: l'allineamento orizzontale del testo nella cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getHorizontalAlignments()
Restituisce gli allineamenti orizzontali delle celle 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]); } }
Invio
String[][]
: un array bidimensionale di allineamenti orizzontali del testo associato alle celle nella
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());
Invio
Integer
: la posizione della colonna finale dell'intervallo nel foglio di lavoro.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getLastRow()
Restituisce la posizione della riga finale.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); // Logs "4.0" Logger.log(range.getLastRow());
Invio
Integer
: la posizione della riga finale dell'intervallo nel foglio di lavoro.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getMergedRanges()
Restituisce un array di Range
oggetti che rappresenta celle unite completamente
all'interno dell'intervallo corrente o contenere 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()); }
Invio
Range[]
: un array di Range
oggetti, che rappresenta le celle unite che si sovrappongono all'intervallo.
getNextDataCell(direction)
Partendo dalla cella nella prima colonna e riga dell'intervallo, restituisce la cella successiva nella
una data direzione, ovvero il bordo di un intervallo contiguo di celle contenenti dati o la cella
sul bordo del foglio di lavoro in quella direzione. Equivale a digitare
Ctrl+[arrow key]
nell'editor.
// Assume the active spreadsheet is blank. 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 successiva cella perimetrale della regione di dati. |
Invio
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());
Invio
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 nell'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]); } }
Invio
String[][]
: un array bidimensionale di note associate alle celle dell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getNumColumns()
Restituisce il numero di colonne in questo intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D5"); Logger.log(range.getNumColumns());
Invio
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());
Invio
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()
Recupera il numero o la formattazione della data nella cella superiore sinistra dell'intervallo specificato. Il formato restituito i pattern sono descritti nell'API Fogli documentazione.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var cell = sheet.getRange("C4"); Logger.log(cell.getNumberFormat());
Invio
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 i formati di numero o data delle celle dell'intervallo. I pattern di formato restituiti sono descritto nella documentazione dell'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]); } }
Invio
String[][]
: un array bidimensionale di formati numerici.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRichTextValue()
Restituisce il valore RTF per la cella superiore sinistra dell'intervallo o null
se la 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());
Invio
RichTextValue
: il valore RTF della cella superiore sinistra nell'intervallo o null
se la 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 delle 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()); } }
Invio
RichTextValue[][]
: un array bidimensionale di valori rich text.
Autorizzazione
Gli script che utilizzano questo 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());
Invio
Integer
: la posizione nella 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());
Invio
Integer
: la posizione nella 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());
Invio
Sheet
: il foglio a cui appartiene questo intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirection()
Restituisce la direzione del testo per la cella superiore sinistra dell'intervallo. Restituisce null
se la cella
la direzione del testo 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());
Invio
TextDirection
: la direzione del testo della cella in alto a sinistra nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getTextDirections()
Restituisce 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]); } }
Invio
TextDirection[][]
: un array bidimensionale di direzioni 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
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());
Invio
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); } }
Invio
TextRotation[][]
: un array bidimensionale di rotazioni di 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);
Invio
TextStyle
: lo stile 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
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]); } }
Invio
TextStyle[][]
: un array bidimensionale di stili di testo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValue()
Restituisce il valore della cella in alto a sinistra dell'intervallo. Il valore può essere di tipo Number
,
Boolean
, Date
o String
a seconda del valore della cella. Vuoto
le celle 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());
Invio
Object
: il valore in questa cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getValues()
Restituisce la griglia rettangolare di valori per questo intervallo.
Restituisce una matrice bidimensionale di valori, indicizzati per riga e poi per colonna. I valori possono essere
di tipo Number
, Boolean
, Date
o String
, a seconda del
della cella. Le celle vuote sono rappresentate da una stringa vuota nell'array. Ricorda che
mentre un indice di intervallo inizia da 1, 1
, l'array JavaScript 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, un valore
Date
non è un parametro legale. Impossibile restituire getValues()
a un'app web se l'intervallo contiene una cella con un valore Date
. Trasforma invece
tutti i valori recuperati dal foglio a una primitiva JavaScript supportata come Number
, Boolean
o String
.Invio
Object[][]
: un array di valori bidimensionale.
Autorizzazione
Gli script che utilizzano questo 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/centrale/in basso) della cella nell'angolo superiore sinistro della intervallo.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getVerticalAlignment());
Invio
String
: l'allineamento verticale del testo nella cella.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getVerticalAlignments()
Restituisce gli allineamenti verticali delle celle nell'intervallo.
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]); } }
Invio
String[][]
: un array bidimensionale di allineamenti verticali di testo associati alle celle nella
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());
Invio
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()
Indica se il testo nella cella va a capo. Per una strategia di wrapping più granulare, utilizza getWrapStrategy()
.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("B2:D4"); Logger.log(range.getWrap());
Invio
Boolean
: indica se il testo in questa cella va a capo o meno.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWrapStrategies()
Restituisce le strategie di 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]); } }
Invio
WrapStrategy[][]
: un array bidimensionale di strategie di wrapping 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
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());
Invio
WrapStrategy
: la strategia di testo a capo della cella in alto a sinistra nell'intervallo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getWraps()
Indica se il testo nelle celle va a capo. Per una strategia di wrapping 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); } } }
Invio
Boolean[][]
: un array bidimensionale di allineamenti verticali di testo associati alle celle nella
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 in precedenza occupava questo intervallo. I dati esistenti nel foglio insieme alla dimensione fornita sono spostata 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 lungo la quale spostare i dati esistenti. |
Invio
Range
: 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, configurate con true
per le caselle selezionate e
false
per deselezionato. Imposta il valore di tutte le celle nell'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();
Invio
Range
: 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 le caselle di controllo in ogni cella dell'intervallo, configurate con un valore personalizzato per le caselle selezionate 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. |
Invio
Range
: 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 le caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per le caselle selezionate e gli stati non selezionati. Imposta il valore di ogni cella dell'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. |
Invio
Range
: 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());
Invio
Boolean
: true
se l'intervallo è vuoto; false
negli altri casi.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isChecked()
Restituisce un valore che indica se tutte le celle nell'intervallo hanno lo stato della casella di controllo "selezionata". Restituisce null
se alcune celle sono selezionate e il resto deselezionato o se per alcune celle non è presente una casella di controllo
e la 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();
Invio
Boolean
: true
, se tutte le celle dell'intervallo sono selezionate, false
se tutte le celle nell'intervallo
un intervallo di date è deselezionato o null
se una delle celle è deselezionata o non contiene
della casella di controllo.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isEndColumnBounded()
Determina se la fine dell'intervallo è associata a una determinata colonna. Ad esempio, per
intervalli A1:B10
o B:B
, associati alle colonne alla fine dell'intervallo, questo
restituisce true
; per gli intervalli 3:7
o A1:5
, che sono limitati 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());
Invio
Boolean
: true
se la fine dell'intervallo è legata a una determinata colonna; false
negli altri casi.
Autorizzazione
Gli script che utilizzano questo 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
intervalli A1:B10
o 3:7
, associati alle righe alla fine dell'intervallo, questo
restituisce true
; per gli intervalli B:B
o A1:C
, che sono limitati solo
a determinate colonne 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());
Invio
Boolean
: true
se la fine dell'intervallo è legata a una determinata riga; false
negli altri casi.
Autorizzazione
Gli script che utilizzano questo 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 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();
Invio
Boolean
: true
se l'intervallo si sovrappone a celle unite, altrimenti restituisce false
.
isStartColumnBounded()
Determina se l'inizio dell'intervallo è legato a una determinata colonna. Ad esempio, per
intervalli A1:B10
o B:B
, associati alle colonne all'inizio dell'intervallo,
questo metodo restituisce true
; per l'intervallo 3:7
, che è associato solo a una riga in
l'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());
Invio
Boolean
: true
se l'inizio dell'intervallo è legato a una determinata colonna; false
negli altri casi.
Autorizzazione
Gli script che utilizzano questo 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
intervalli A1:B10
o 3:7
, associati alle righe all'inizio dell'intervallo, questo
restituisce true
; per l'intervallo B:B
, che è associato solo a un particolare
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());
Invio
Boolean
: true
se l'inizio dell'intervallo è legato a una determinata riga; false
negli altri casi.
Autorizzazione
Gli script che utilizzano questo 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();
Invio
Range
: 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();
Invio
Range
: intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
mergeVertically()
Unisce le celle nell'intervallo.
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();
Invio
Range
: 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 target in cui copiare questo intervallo; solo la posizione della cella in alto a sinistra è pertinenti. |
Autorizzazione
Gli script che utilizzano questo 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 è spostato rispetto a questo intervallo del 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 dalla cella superiore sinistra dell'intervallo; valori negativi rappresentare le righe in alto rispetto alla cella superiore sinistra dell'intervallo. |
columnOffset | Integer | Il numero di colonne a destra dalla cella superiore sinistra dell'intervallo; valori negativi rappresenta le colonne a sinistra dalla cella superiore sinistra dell'intervallo. |
Invio
Range
: intervallo, per il concatenamento.
offset(rowOffset, columnOffset, numRows)
Restituisce un nuovo intervallo relativo all'intervallo corrente, il cui punto in alto a sinistra è Offset dall'intervallo corrente per le righe e le colonne date 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 dalla cella superiore sinistra dell'intervallo; valori negativi rappresentare le righe in alto rispetto alla cella superiore sinistra dell'intervallo. |
columnOffset | Integer | Il numero di colonne a destra dalla cella superiore sinistra dell'intervallo; valori negativi rappresenta le colonne a sinistra dalla cella superiore sinistra dell'intervallo. |
numRows | Integer | L'altezza in righe del nuovo intervallo. |
Invio
Range
: intervallo, per il concatenamento.
offset(rowOffset, columnOffset, numRows, numColumns)
Restituisce un nuovo intervallo relativo all'intervallo corrente, il cui punto in alto a sinistra è Offset dall'intervallo corrente per le righe e le colonne date e con l'altezza e la larghezza specificate 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 dalla cella superiore sinistra dell'intervallo; valori negativi rappresentare le righe in alto rispetto alla cella superiore sinistra dell'intervallo. |
columnOffset | Integer | Il numero di colonne a destra dalla cella superiore sinistra dell'intervallo; valori negativi rappresenta le colonne a sinistra dalla cella superiore sinistra dell'intervallo. |
numRows | Integer | L'altezza in righe del nuovo intervallo. |
numColumns | Integer | La larghezza in colonne del nuovo intervallo. |
Invio
Range
: intervallo, per il concatenamento.
protect()
Crea un oggetto in grado di proteggere l'intervallo dalla modifica, tranne che per gli utenti che hanno
autorizzazione. Finché lo script non cambia effettivamente l'elenco degli editor per l'intervallo (chiamando
Protection.removeEditor(emailAddress)
, Protection.removeEditor(user)
, Protection.removeEditors(emailAddresses)
, Protection.addEditor(emailAddress)
, Protection.addEditor(user)
, Protection.addEditors(emailAddresses)
o l'impostazione di una nuova
per Protection.setDomainEdit(editable)
), le autorizzazioni rispecchiano quelle del
foglio di lavoro stesso, il che significa che l'intervallo rimane non protetto. Se l'intervallo è
già protetto, questo metodo crea un nuovo intervallo protetto che si sovrappone a quello esistente. Se
una cella è protetta da più intervalli protetti e uno di questi impedisce a un determinato utente di
la cella, l'utente non è autorizzato a modificarla.
// 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); }
Invio
Protection
: un oggetto che rappresenta le impostazioni di protezione.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
randomize()
Randomizza l'ordine delle righe nell'intervallo specificato.
var ss = SpreadsheetApp.getActiveSpreadsheet(); var sheet = ss.getSheets()[0]; var range = sheet.getRange("A1:C7"); // Randomizes the range range.randomize();
Invio
Range
: 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 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();
Invio
Range
: intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates()
Rimuove le righe all'interno di questo intervallo che contengono valori che sono duplicati di valori in qualsiasi riga precedente. Righe con valori identici ma lettere maiuscole, formattazione o formule diverse vengono considerati duplicati. Questo metodo rimuove anche le righe duplicate nascoste (ad ad esempio, a causa di un filtro). I contenuti che non rientrano in 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();
Invio
Range
: intervallo risultante dopo la rimozione dei duplicati. La dimensione dell'intervallo viene ridotta di
riga per ogni riga rimossa.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeDuplicates(columnsToCompare)
Rimuove le righe all'interno di questo intervallo che contengono valori duplicati nelle colonne specificate di valori in una qualsiasi riga precedente. Righe con valori identici ma diversi lettere maiuscole e minuscole, formattazione o formule sono considerati duplicati. Questo metodo rimuove anche le righe duplicate nascoste dalla visualizzazione (ad esempio, a causa di un filtro). I contenuti che non rientrano in 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 individuare i duplicati. |
Invio
Range
: intervallo risultante dopo la rimozione dei duplicati. La dimensione dell'intervallo viene ridotta di
riga per ogni riga rimossa.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackground(color)
Imposta il colore di sfondo di tutte le celle nell'intervallo nella notazione CSS (ad esempio '#ffffff'
o 'white'
).
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 (ad esempio '#ffffff' o 'white' ); un
Il valore null reimposta il colore. |
Invio
Range
: 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 di sfondo. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di colori di sfondo (deve 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 di null reimpostano il colore. |
Invio
Range
: 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. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di colori di sfondo (deve corrispondere alle dimensioni di questo intervallo). I colori
sono in notazione CSS (ad esempio '#ffffff'
o 'white'
).
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 (ad esempio '#ffffff' o
'white' ); I valori di null reimpostano il colore. |
Invio
Range
: 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, null per nessuna modifica. |
left | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
bottom | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
right | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
vertical | Boolean | true per 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. |
Invio
Range
: 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 il colore e/o lo stile. I valori validi sono true
(on), false
(off) e null
(nessuna modifica). Per il colore, utilizza l'attributo 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, null per nessuna modifica. |
left | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
bottom | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
right | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
vertical | Boolean | true per 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 in 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). |
Invio
Range
: 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. |
Invio
Range
: 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 modello array di convalide dei dati, indicizzati 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; null valori
rimuovere la convalida dei dati. |
Invio
Range
: 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 (ad esempio '#ffffff' o 'white' ). un
Il valore null reimposta il colore. |
Invio
Range
: 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. |
Invio
Range
: 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 (deve 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 di null reimpostano il colore del carattere. |
Invio
Range
: 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 (deve corrispondere alle dimensioni di questo intervallo). I colori sono in
Notazione CSS (ad esempio '#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 (ad esempio '#ffffff' o
'white' ); I valori di null reimpostano il colore. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di famiglie di caratteri (deve corrispondere alle dimensioni di questo intervallo). Esempi di le famiglie di caratteri sono "Arial" o "HЧ".
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 di null reimpostano il
famiglia di caratteri. |
Invio
Range
: 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 "HЧ".
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. |
Invio
Range
: intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLine(fontLine)
Imposta lo stile della linea del carattere dell'intervallo specificato ('underline'
, 'line-through'
o
'none'
).
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. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di stili di linea (deve 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 linea di caratteri ('underline' , 'line-through' o 'none' ); I valori di null reimpostano lo stile della riga del carattere. |
Invio
Range
: intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSize(size)
Imposta la dimensione del carattere, che rappresenta la dimensione in punto 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 dimensione in punti. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di dimensioni dei caratteri (deve corrispondere alle dimensioni di questo intervallo). Le dimensioni sono 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. |
Invio
Range
: 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 | Stile del carattere, 'italic' o 'normal' ; null
reimposta lo stile del carattere. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di stili di carattere (deve 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 di caratteri, 'italic' o 'normal' ; I valori di null reimpostano lo stile del carattere. |
Invio
Range
: 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' . null
reimposta lo spessore del carattere. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di spessori dei caratteri (deve corrispondere alle dimensioni di questo intervallo). Un esempio di lo spessore del carattere è "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 dei caratteri, 'bold' o 'normal' ; I valori di null reimpostano lo spessore del carattere. |
Invio
Range
: 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 l'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. |
Invio
Range
: 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 l'intervallo. La formula specificata deve essere espressa 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. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di formule (deve corrispondere alle dimensioni di questo intervallo). Le formule specificate deve essere in notazione A1. Questo metodo prende una matrice bidimensionale di formule, indicizzate per riga, quindi 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 di formule stringa bidimensionale. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di formule (deve corrispondere alle dimensioni di questo intervallo). Le formule specificate deve 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. |
Invio
Range
: 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
Il valore null reimposta l'allineamento. |
Invio
Range
: 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)
Consente di impostare 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. |
Invio
Range
: 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. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di note (deve 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; null valori rimuovono la nota. |
Invio
Range
: 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 del numero o della data sulla stringa di formattazione specificata. I pattern di formato accettati sono descritto nella documentazione dell'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 in formato numerico. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di formati numeri o data (deve corrispondere alle dimensioni di questo intervallo). La sono stringhe con pattern di formato come descritto in documentazione dell'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. |
Invio
Range
: 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. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di valori rich text.
// 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. |
Invio
Range
: 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. |
Invio
Range
: 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 delle 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'ambientazione. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di direzioni di testo. Se una direzione specificata è null
, il valore
dedotta e poi 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 di testo desiderate; Se una direzione specificata è null , è
dedotti prima dell'impostazione. |
Invio
Range
: 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 configurare 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 valore pari a zero indica che il testo sia 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'angolazione desiderata tra l'orientamento standard e l'orientamento desiderato. Per il testo da sinistra a destra, gli angoli positivi sono in senso antiorario. |
Invio
Range
: 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 configurare 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. |
Invio
Range
: 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)
Consente di impostare 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. |
Invio
Range
: 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. |
Invio
Range
: 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)
Consente di impostare 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. |
Invio
Range
: 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 interpretata 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. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di valori (deve 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 di valori bidimensionale. |
Invio
Range
: 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 (superiore/centro/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
Il valore null reimposta l'allineamento. |
Invio
Range
: 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)
Consente di impostare una griglia rettangolare di allineamenti verticali (deve 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. |
Invio
Range
: 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 stabilire se sovrapporre o meno il testo per le celle dell'intervallo. Se il testo è sovrapposto verticalmente, l'impostazione della rotazione del testo dei 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. |
Invio
Range
: 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 wrapping di celle dell'intervallo specificato.
Le celle in cui è attivo il wrapping (impostazione predefinita) vengono ridimensionate in modo da visualizzarne l'intero contenuto. Celle con wrapping disattiva la visualizzazione il più possibile nella cella senza ridimensionarla o eseguire la visualizzazione 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. |
Invio
Range
: 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)
Consente di impostare 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. |
Invio
Range
: 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 nell'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. |
Invio
Range
: 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). Celle con l'avvolgimento abilitato (impostazione predefinita) viene ridimensionato per visualizzarne l'intero contenuto. Celle con wrapping disabilitato visualizza il maggior numero possibile di immagini nella cella senza ridimensionarla o eseguire il deployment 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 di wrapping che determinano se applicare o meno il wrapping testo presente in una cella o meno. |
Invio
Range
: 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à del raggruppamento delle colonne dell'intervallo in base al valore specificato.
Ciò ha l'effetto di creare, modificare o eliminare i gruppi che si intersecano con intervallo. Per i delta positivi, i gruppi vengono creati e/o modificati; per i delta negativi, i gruppi vengono eliminati e/o modificati.
Questo non ha effetto se diminuisci la profondità del gruppo al di sotto di zero o al di sopra di otto.
Se column group control position
è
BEFORE
, viene generato un errore quando tenti 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 | Il valore in base al quale modificare la profondità del gruppo di colonne di questo intervallo. |
Invio
Range
: intervallo, per il concatenamento.
Lanci
Error
: quando tenti 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à del raggruppamento delle righe dell'intervallo in base al valore specificato.
Ciò ha l'effetto di creare, modificare o eliminare i gruppi che si intersecano con intervallo. Per i delta positivi, i gruppi vengono creati e/o modificati; per i delta negativi, i gruppi vengono eliminati e/o modificati.
Questo non ha effetto se diminuisci la profondità del gruppo al di sotto di zero o al di sopra di otto.
Se row group control position
è BEFORE
, viene generato un errore quando si cerca di spostare il valore
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 | Il valore in base al quale modificare la profondità del gruppo di righe di questo intervallo. |
Invio
Range
: intervallo, per il concatenamento.
Lanci
Error
: quando tenti di spostare la profondità della prima riga quando il controllo
la posizione è GroupControlTogglePosition.BEFORE
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
sort(sortSpecObj)
Ordina le celle nell'intervallo specificato, in base alla colonna e all'ordine specificato.
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. |
Invio
Range
: 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 in base al quale 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 in base al quale eseguire la suddivisione. |
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trimWhitespace()
Taglia gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella dell'intervallo. Rimuove tutti gli spazi vuoti all'inizio e alla fine del testo di ciascuna cella e riduce eventuali sottosequenze di spazi vuoti rimanenti in un singolo spazio.
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)']
Invio
Range
: intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
uncheck()
Modifica lo stato delle caselle di controllo nell'intervallo in "deselezionata". Ignora le celle nell'intervallo che al momento 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();
Invio
Range
: 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