Una raccolta di una o più istanze Range
nello stesso foglio. Puoi usare questa classe per applicare operazioni su raccolte di intervalli o celle non adiacenti.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
activate() | RangeList | Seleziona l'elenco di istanze Range . |
breakApart() | RangeList | Suddivide di nuovo tutte le celle unite orizzontalmente o verticalmente contenute nell'elenco degli intervalli in singole celle. |
check() | RangeList | Modifica lo stato delle caselle di controllo nell'intervallo in "Selezionate". |
clear() | RangeList | Cancella l'intervallo di contenuti, i formati e le regole di convalida dei dati per ogni Range
nell'elenco di intervalli. |
clear(options) | RangeList | Cancella l'intervallo di contenuti, il formato, le regole di convalida dei dati e i commenti, come specificato con le opzioni specificate. |
clearContent() | RangeList | Cancella il contenuto di ogni Range nell'elenco degli intervalli, senza modificare la formattazione. |
clearDataValidations() | RangeList | Cancella le regole di convalida dei dati per ogni Range nell'elenco di intervalli. |
clearFormat() | RangeList | Cancella la formattazione del testo per ogni Range nell'elenco di intervalli. |
clearNote() | RangeList | Cancella la nota per ogni Range nell'elenco di intervalli. |
getRanges() | Range[] | Restituisce un elenco di una o più istanze Range nello stesso foglio. |
insertCheckboxes() | RangeList | Inserisce le caselle di controllo in ogni cella dell'intervallo, configurata con true per selezionata e false per deselezionata. |
insertCheckboxes(checkedValue) | RangeList | Inserisce caselle di controllo in ogni cella dell'intervallo, configurata con un valore personalizzato per selezionata e la stringa vuota per deselezionata. |
insertCheckboxes(checkedValue, uncheckedValue) | RangeList | Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e non selezionati. |
removeCheckboxes() | RangeList | Rimuove tutte le caselle di controllo dall'intervallo. |
setBackground(color) | RangeList | Imposta il colore di sfondo per ogni Range nell'elenco di intervalli. |
setBackgroundRGB(red, green, blue) | RangeList | Imposta lo sfondo sul colore RGB specificato. |
setBorder(top, left, bottom, right, vertical, horizontal) | RangeList | Imposta la proprietà del bordo per ogni Range nell'elenco di intervalli. |
setBorder(top, left, bottom, right, vertical, horizontal, color, style) | RangeList | Imposta la proprietà del bordo con un colore e/o uno stile per ogni Range nell'elenco dell'intervallo. |
setFontColor(color) | RangeList | Imposta il colore del carattere per ogni Range nell'elenco dell'intervallo. |
setFontFamily(fontFamily) | RangeList | Imposta la famiglia di caratteri per ogni Range nell'elenco di intervalli. |
setFontLine(fontLine) | RangeList | Imposta lo stile della linea del carattere per ogni Range nell'elenco dell'intervallo. |
setFontSize(size) | RangeList | Imposta la dimensione carattere (in punti) per ogni Range nell'elenco dell'intervallo. |
setFontStyle(fontStyle) | RangeList | Imposta lo stile del carattere per ogni Range nell'elenco dell'intervallo. |
setFontWeight(fontWeight) | RangeList | Imposta lo spessore del carattere per ogni Range nell'elenco dell'intervallo. |
setFormula(formula) | RangeList | Aggiorna la formula per ogni Range nell'elenco dell'intervallo. |
setFormulaR1C1(formula) | RangeList | Aggiorna la formula per ogni Range nell'elenco dell'intervallo. |
setHorizontalAlignment(alignment) | RangeList | Imposta l'allineamento orizzontale per ogni Range nell'elenco di intervalli. |
setNote(note) | RangeList | Imposta il testo della nota per ogni Range nell'elenco dell'intervallo. |
setNumberFormat(numberFormat) | RangeList | Consente di impostare il formato numerico o data per ogni Range nell'elenco di intervalli. |
setShowHyperlink(showHyperlink) | RangeList | Consente di stabilire se ogni Range dell'elenco di intervalli deve mostrare o meno i link ipertestuali. |
setTextDirection(direction) | RangeList | Imposta la direzione del testo per le celle in ogni Range nell'elenco degli intervalli. |
setTextRotation(degrees) | RangeList | Consente di impostare le impostazioni di rotazione del testo per le celle in ogni Range nell'elenco degli intervalli. |
setValue(value) | RangeList | Imposta il valore di ogni Range nell'elenco di intervalli. |
setVerticalAlignment(alignment) | RangeList | Imposta l'allineamento verticale per ogni Range nell'elenco degli intervalli. |
setVerticalText(isVertical) | RangeList | Consente di impostare se sovrapporre o meno il testo delle celle per ogni Range nell'elenco dell'intervallo. |
setWrap(isWrapEnabled) | RangeList | Imposta il ritorno a capo automatico per ogni Range nell'elenco di intervalli. |
setWrapStrategy(strategy) | RangeList | Imposta la strategia di testo a capo per ogni Range nell'elenco di intervalli. |
trimWhitespace() | RangeList | Modifica gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella dell'elenco di intervalli. |
uncheck() | RangeList | Modifica lo stato delle caselle di controllo nell'intervallo in "Deselezionata". |
Documentazione dettagliata
activate()
Seleziona l'elenco di istanze Range
. L'ultimo intervallo nell'elenco è impostato come active range
.
Nota:in questo modo puoi selezionare più intervalli di un numero di intervalli.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.activate(); var selection = sheet.getSelection(); // Current cell: B2 var currentCell = selection.getCurrentCell(); // Active range: B2:C4 var activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] var activeRangeList = selection.getActiveRangeList();
Ritorni
RangeList
: l'elenco di intervalli attivi, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo 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()
Suddivide di nuovo tutte le celle unite orizzontalmente o verticalmente contenute nell'elenco degli intervalli in singole celle.
Richiamare questa funzione in un elenco di intervalli equivale a selezionare un insieme di intervalli e la voce di menu Formato > Unisci > Dividi fogli.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
check()
Modifica lo stato delle caselle di controllo nell'intervallo in "Selezionata". Ignora le celle nell'intervallo che attualmente non contengono il valore selezionato o deselezionato configurato.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the ranges D4 and E6 to 'checked'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.check();
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear()
Cancella l'intervallo di contenuti, i formati e le regole di convalida dei dati per ogni Range
nell'elenco di intervalli.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear();
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clear(options)
Cancella l'intervallo di contenuti, il formato, le regole di convalida dei dati e i commenti, come specificato con le opzioni specificate. Per impostazione predefinita, tutti i dati vengono cancellati.
// The code below clears the contents of the following ranges A:A and C:C in the active sheet, // but preserves the format, data validation rules, and comments. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear({contentsOnly: true});
Parametri
Nome | Tipo | Descrizione |
---|---|---|
options | Object | Un oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito. |
Parametri avanzati
Nome | Tipo | Descrizione |
---|---|---|
commentsOnly | Boolean | Indica se cancellare solo i commenti. |
contentsOnly | Boolean | Indica se cancellare solo i contenuti. |
formatOnly | Boolean | Indica se cancellare solo il formato. Tieni presente che la cancellazione del formato comporta anche la cancellazione delle regole di convalida dei dati. |
validationsOnly | Boolean | Indica se cancellare solo le regole di convalida dei dati. |
skipFilteredRows | Boolean | Indica se evitare di cancellare le righe filtrate. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearContent()
Cancella il contenuto di ogni Range
nell'elenco degli intervalli, senza modificare la formattazione.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearContent();
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearDataValidations()
Cancella le regole di convalida dei dati per ogni Range
nell'elenco di intervalli.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearDataValidations();
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearFormat()
Cancella la formattazione del testo per ogni Range
nell'elenco di intervalli.
Questa operazione cancella la formattazione del testo per ogni intervallo, ma non reimposta le regole di formattazione dei numeri.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearFormat();
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
clearNote()
Cancella la nota per ogni Range
nell'elenco di intervalli.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearNote();
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRanges()
Restituisce un elenco di una o più istanze Range
nello stesso foglio.
Ritorni
Range[]
: l'elenco di intervalli.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes()
Inserisce le caselle di controllo in ogni cella dell'intervallo, configurata con true
per selezionata e false
per deselezionata. Imposta il valore di tutte le celle dell'intervallo su false
.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'true' for checked // and 'false' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to // 'false'. rangeList.insertCheckboxes();
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue)
Inserisce caselle di controllo in ogni cella dell'intervallo, configurata con un valore personalizzato per selezionata e la stringa vuota per deselezionata. Imposta il valore di ogni cella dell'intervallo sulla stringa vuota.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked // and the empty string for unchecked. Also, sets the value of each cell in the ranges D4 and // E6 to the empty string. rangeList.insertCheckboxes('yes');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
checkedValue | Object | Il valore selezionato per la convalida dei dati della casella di controllo. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insertCheckboxes(checkedValue, uncheckedValue)
Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e non selezionati. Imposta il valore di ogni cella nell'intervallo sul valore personalizzato deselezionato.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); // Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked // and 'no' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to 'no'. rangeList.insertCheckboxes('yes', 'no');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
checkedValue | Object | Il valore selezionato per la convalida dei dati della casella di controllo. |
uncheckedValue | Object | Il valore deselezionato per la convalida dei dati della casella di controllo. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
removeCheckboxes()
Rimuove tutte le caselle di controllo dall'intervallo. Cancella la convalida dei dati di ogni cella e cancella anche il relativo valore se la cella contiene il valore selezionato o deselezionato.
var range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); var rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']); rangeList1.setValue('yes'); // Removes the checkbox data validation in cells A1 and A3 and clears their value. rangeList1.removeCheckboxes(); var rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']); rangeList2.setValue('random'); // Removes the checkbox data validation in cells A5 and A7 but does not clear their value. rangeList2.removeCheckboxes();
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackground(color)
Imposta il colore di sfondo per ogni Range
nell'elenco di intervalli. Il colore è rappresentato nella notazione CSS, ad esempio '#ffffff'
o 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setBackground('red');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il codice del colore di sfondo nella notazione CSS, come '#ffffff' o 'white' ; un valore null reimposta il colore. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBackgroundRGB(red, green, blue)
Imposta lo sfondo sul colore RGB specificato. Questo è un wrapper di convenienza per una chiamata setBackground(color)
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); // Sets the background to red for each range in the range list. rangeList.setBackgroundRGB(255, 0, 0);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
red | Integer | Il valore rosso in notazione RGB. |
green | Integer | Il valore verde in notazione RGB. |
blue | Integer | Il valore blu in notazione RGB. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal)
Imposta la proprietà del bordo per ogni Range
nell'elenco di intervalli. I valori validi sono
true
(on), false
(off) e null
(nessuna modifica).
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']); // Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves the left and // right unchanged. rangeList.setBorder(true, null, true, null, false, false);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
top | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
left | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
bottom | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
right | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
vertical | Boolean | true per i bordi verticali interni, false per nessuno, null per nessuna modifica. |
horizontal | Boolean | true per i bordi orizzontali interni, false per nessuno, null per nessuna modifica. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setBorder(top, left, bottom, right, vertical, horizontal, color, style)
Imposta la proprietà del bordo con un colore e/o uno stile per ogni Range
nell'elenco dell'intervallo.
I valori validi sono true
(on), false
(off) e null
(nessuna modifica). Il colore è
rappresentato nella notazione CSS, ad esempio '#ffffff'
o 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']); // Sets borders on the top and bottom, but leaves the left and right unchanged of the ranges // A2:B4 and C1:D4. Also sets the color to 'red', and the border to 'DASHED'. rangeList.setBorder( true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
top | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
left | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
bottom | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
right | Boolean | true per il bordo, false per nessuno e null per nessuna modifica. |
vertical | Boolean | true per i bordi verticali interni, false per nessuno, null per nessuna modifica. |
horizontal | Boolean | true per i bordi orizzontali interni, false per nessuno, null per nessuna modifica. |
color | String | Il colore del bordo nella notazione CSS come '#ffffff' o 'white' , null per il colore predefinito (nero). |
style | BorderStyle | Lo stile dei bordi, null per lo stile predefinito (solido). |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontColor(color)
Imposta il colore del carattere per ogni Range
nell'elenco dell'intervallo. Il colore è rappresentato nella notazione CSS,
ad esempio, '#ffffff'
o 'white'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontColor('red');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del carattere nella notazione CSS, come '#ffffff' o 'white' ; un valore null reimposta il colore. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontFamily(fontFamily)
Imposta la famiglia di caratteri per ogni Range
nell'elenco di intervalli. La famiglia di caratteri è descritta
da un identificatore stringa come Arial
o Roboto
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontFamily('Roboto');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontFamily | String | La famiglia di caratteri da impostare; un valore null reimposta la famiglia di caratteri. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontLine(fontLine)
Imposta lo stile della linea del carattere per ogni Range
nell'elenco dell'intervallo. Le opzioni per gli stili della linea
sono 'underline'
, 'line-through'
o 'none'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontLine('line-through');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontLine | String | Lo stile della linea del carattere, 'underline' , 'line-through' o 'none' ; un valore null reimposta lo stile della linea del carattere. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontSize(size)
Imposta la dimensione carattere (in punti) per ogni Range
nell'elenco dell'intervallo.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontSize(20);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
size | Integer | La dimensione in punti del carattere. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontStyle(fontStyle)
Imposta lo stile del carattere per ogni Range
nell'elenco dell'intervallo. Le opzioni di stile del carattere sono 'italic'
o 'normal'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontStyle("italic");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontStyle | String | Lo stile del carattere, 'italic' o 'normal' ; un valore null reimposta lo stile del carattere. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFontWeight(fontWeight)
Imposta lo spessore del carattere per ogni Range
nell'elenco dell'intervallo. Le opzioni relative allo spessore del carattere sono 'normal'
o 'bold'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontWeight('bold');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
fontWeight | String | Lo spessore del carattere, 'bold' o 'normal' ; un valore null reimposta lo spessore del carattere. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormula(formula)
Aggiorna la formula per ogni Range
nell'elenco dell'intervallo. La formula deve essere
in notazione A1.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A11', 'C11']); rangeList.setFormula('=SUM(B1:B10)');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
formula | String | Una stringa che rappresenta la formula da impostare. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setFormulaR1C1(formula)
Aggiorna la formula per ogni Range
nell'elenco dell'intervallo. La formula data deve essere
in notazione R1C1.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A11', 'C11']); // This sets the formula to be the sum of the 3 rows above B5 rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
formula | String | Una formula stringa. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setHorizontalAlignment(alignment)
Imposta l'allineamento orizzontale per ogni Range
nell'elenco di intervalli. Le opzioni di allineamento sono 'left'
, 'center'
o 'right'
.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setHorizontalAlignment("center");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
alignment | String | L'allineamento, 'left' , 'center' o 'normal' ; un valore null reimposta l'allineamento. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNote(note)
Imposta il testo della nota per ogni Range
nell'elenco dell'intervallo.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setNote('This is a note');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
note | String | Il testo della nota da impostare; un valore null rimuove la nota. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setNumberFormat(numberFormat)
Consente di impostare il formato numerico o data per ogni Range
nell'elenco di intervalli.
I modelli di formattazione accettati sono descritti nella Guida alla formattazione di date e numeri dell'API Fogli.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Always show 3 decimal points for the specified ranges. rangeList.setNumberFormat('0.000');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
numberFormat | String | Una stringa di formato numerico. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setShowHyperlink(showHyperlink)
Consente di stabilire se ogni Range
dell'elenco di intervalli deve mostrare o meno i link ipertestuali.
var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Show hyperlinks for all the ranges. rangeList.setShowHyperlink(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
showHyperlink | Boolean | Indica se mostrare o meno il link ipertestuale. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextDirection(direction)
Imposta la direzione del testo per le celle in ogni Range
nell'elenco degli intervalli. Se una direzione specificata è null
, la direzione viene dedotta e quindi impostata.
// Sets right-to-left text direction each range in the range list. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
direction | TextDirection | La direzione del testo desiderata; se null la direzione viene dedotta prima dell'impostazione. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setTextRotation(degrees)
Consente di impostare le impostazioni di rotazione del testo per le celle in ogni Range
nell'elenco degli intervalli. L'input corrisponde all'angolo tra l'orientamento standard del testo e l'orientamento desiderato. Un valore pari a zero indica che il testo è impostato sull'orientamento standard.
Per la direzione del testo da sinistra a destra, gli angoli positivi sono in senso antiorario, mentre da destra a sinistra sono in senso orario.
// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextRotation(45);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
degrees | Integer | L'angolo desiderato tra l'orientamento standard e quello desiderato. Per il testo da sinistra a destra, gli angoli positivi sono orientati in senso antiorario. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setValue(value)
Imposta il valore di ogni Range
nell'elenco di intervalli. Il valore può essere numerico, stringa,
booleano o data. Se inizia con "=", viene interpretato come una formula.
var sheet = SpreadsheetApp.getActiveSheet(); // Set value of 100 to each range in the range list. var rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setValue(100);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | Object | Il valore dell'intervallo. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalAlignment(alignment)
Imposta l'allineamento verticale per ogni Range
nell'elenco degli intervalli. Le opzioni di allineamento sono 'top'
, 'middle'
o 'bottom'
.
// Sets the vertical alignment to middle for the list of ranges. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalAlignment("middle");
Parametri
Nome | Tipo | Descrizione |
---|---|---|
alignment | String | L'allineamento, 'top' , 'middle' o 'bottom' ; un valore null reimposta l'allineamento. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setVerticalText(isVertical)
Consente di impostare se sovrapporre o meno il testo delle celle per ogni Range
nell'elenco dell'intervallo. Se il testo è impilato verticalmente, l'impostazione di rotazione del testo in gradi viene ignorata.
// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalText(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
isVertical | Boolean | Indica se sovrapporre o meno il testo. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrap(isWrapEnabled)
Imposta il ritorno a capo automatico per ogni Range
nell'elenco di intervalli. Le celle in cui è abilitato il wrapping vengono ridimensionate
per visualizzare il contenuto completo. Le celle con wrapping disattivato vengono visualizzate il più possibile nella cella senza ridimensionare o eseguire su più righe.
// Enable text wrap for the list of ranges. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrap(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
isWrapEnabled | Boolean | Indica se mandare a capo o meno il testo. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
setWrapStrategy(strategy)
Imposta la strategia di testo a capo per ogni Range
nell'elenco di intervalli.
// Sets the list of ranges to use the clip wrap strategy. var sheet = SpreadsheetApp.getActiveSheet(); var rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strategy | WrapStrategy | La strategia di wrapping desiderata. |
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trimWhitespace()
Modifica gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella dell'elenco di intervalli. Rimuove gli spazi vuoti all'inizio e alla fine del testo di ogni cella e riduce a un unico spazio eventuali sottosequenze di spazi vuoti rimanenti.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange('A1:A4'); range.activate(); range.setValues( [' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)']); var rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']); rangeList.trimWhitespace(); var values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
Vedi anche
uncheck()
Modifica lo stato delle caselle di controllo nell'intervallo su "Deselezionata". Ignora le celle nell'intervallo che attualmente non contengono il valore selezionato o deselezionato configurato.
// Changes the state of cells which currently contain either the checked or unchecked value // configured in the ranges D4 and E6 to 'unchecked'. var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.uncheck();
Ritorni
RangeList
: elenco di questo intervallo, per il concatenamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets