Una raccolta di una o più istanze di Range
nello stesso foglio. Puoi utilizzare questa classe per applicare operazioni a raccolte di intervalli o celle non adiacenti.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
activate() | Range | Seleziona l'elenco di istanze Range . |
break | Range | Suddividi nuovamente tutte le celle unite orizzontalmente o verticalmente contenute nell'elenco di intervalli in singole celle. |
check() | Range | Modifica lo stato delle caselle di controllo nell'intervallo in "selezionata". |
clear() | Range | Cancella l'intervallo di contenuti, formati e regole di convalida dei dati per ogni Range nell'elenco degli intervalli. |
clear(options) | Range | Cancella l'intervallo di contenuti, il formato, le regole di convalida dei dati e i commenti, come specificato con le opzioni indicate. |
clear | Range | Cancella i contenuti di ogni Range nell'elenco dell'intervallo, lasciando invariata la formattazione. |
clear | Range | Cancella le regole di convalida dei dati per ogni Range nell'elenco dell'intervallo. |
clear | Range | Cancella la formattazione del testo per ogni Range nell'elenco dell'intervallo. |
clear | Range | Cancella la nota per ogni Range nell'elenco di intervalli. |
get | Range[] | Restituisce un elenco di una o più istanze Range nello stesso foglio. |
insert | Range | Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con true per la selezione e
false per la mancata selezione. |
insert | Range | Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con un valore personalizzato per la selezione e la stringa vuota per la mancata selezione. |
insert | Range | Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e deselezionati. |
remove | Range | Rimuove tutte le caselle di controllo dall'intervallo. |
set | Range | Imposta il colore di sfondo per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta lo sfondo sul colore RGB specificato. |
set | Range | Imposta la proprietà bordo per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta la proprietà del bordo con il colore e/o lo stile per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta il colore del carattere per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta la famiglia di caratteri per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta lo stile della linea del carattere per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta la dimensione del carattere (in punti) per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta lo stile del carattere per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta l'intensità del carattere per ogni Range nell'elenco dell'intervallo. |
set | Range | Aggiorna la formula per ogni Range nell'elenco dell'intervallo. |
set | Range | Aggiorna la formula per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta l'allineamento orizzontale per ogni Range nell'elenco di intervalli. |
set | Range | Imposta il testo della nota per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta il formato numerico o della data per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta se mostrare o meno i link ipertestuali per ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta la direzione del testo per le celle in ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta le impostazioni di rotazione del testo per le celle di ogni Range nell'elenco dell'intervallo. |
set | Range | Imposta il valore per ogni Range nell'elenco di intervalli. |
set | Range | Imposta l'allineamento verticale per ogni Range nell'elenco di intervalli. |
set | Range | Imposta se impilare o meno il testo per le celle di ogni Range nell'elenco
dell'intervallo. |
set | Range | Imposta il rientro del testo per ogni Range nell'elenco di intervalli. |
set | Range | Imposta la strategia di a capo del testo per ogni Range nell'elenco dell'intervallo. |
trim | Range | Taglia gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella di questo elenco di intervalli. |
uncheck() | Range | Imposta lo stato delle caselle di controllo nell'intervallo su "non selezionata". |
Documentazione dettagliata
activate()
Seleziona l'elenco di istanze Range
. L'ultimo intervallo nell'elenco è impostato come active range
.
Nota:questo consente di selezionare più intervalli.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.activate(); const selection = sheet.getSelection(); // Current cell: B2 const currentCell = selection.getCurrentCell(); // Active range: B2:C4 const activeRange = selection.getActiveRange(); // Active range list: [D4, B2:C4] const activeRangeList = selection.getActiveRangeList();
Invio
Range
: l'elenco degli intervalli attivi, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
break Apart()
Suddividi nuovamente tutte le celle unite orizzontalmente o verticalmente contenute nell'elenco di intervalli in singole celle.
La chiamata di questa funzione su un elenco di intervalli è equivalente alla selezione di un insieme di intervalli e della voce di menu Formato > Unisci > Dividi di Fogli.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.breakApart();
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo 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 ranges D4 and E6 to 'checked'. const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.check();
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo 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, formati e regole di convalida dei dati per ogni Range
nell'elenco degli intervalli.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clear();
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo 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 indicate. 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. const sheet = SpreadsheetApp.getActiveSheet(); const 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 |
---|---|---|
comments | Boolean | Indica se cancellare solo i commenti. |
contents | Boolean | Indica se cancellare solo i contenuti. |
format | Boolean | Se cancellare solo la formattazione; tieni presente che la cancellazione della formattazione comporta anche l'eliminazione delle regole di convalida dei dati. |
validations | Boolean | Indica se cancellare solo le regole di convalida dei dati. |
skip | Boolean | Indica se evitare di cancellare le righe filtrate. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo 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 Content()
Cancella i contenuti di ogni Range
nell'elenco dell'intervallo, lasciando invariata la formattazione.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearContent();
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo 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 Data Validations()
Cancella le regole di convalida dei dati per ogni Range
nell'elenco dell'intervallo.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearDataValidations();
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo 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 Format()
Cancella la formattazione del testo per ogni Range
nell'elenco dell'intervallo.
In questo modo viene cancellata la formattazione del testo per ogni intervallo, ma non vengono reimpostate le regole di formattazione dei numeri.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearFormat();
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo 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 Note()
Cancella la nota per ogni Range
nell'elenco di intervalli.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.clearNote();
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
get Ranges()
Restituisce un elenco di una o più istanze Range
nello stesso foglio.
Invio
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
insert Checkboxes()
Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con true
per la selezione e
false
per la mancata selezione. Imposta il valore di tutte le celle dell'intervallo su false
.
const 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();
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes(checkedValue)
Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con un valore personalizzato per la selezione e la stringa vuota per la mancata selezione. Imposta il valore di ogni cella dell'intervallo sulla stringa vuota.
const 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 |
---|---|---|
checked | Object | Il valore selezionato per la convalida dei dati della casella di controllo. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
insert Checkboxes(checkedValue, uncheckedValue)
Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e deselezionati. Imposta il valore di ogni cella dell'intervallo sul valore non selezionato personalizzato.
const 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 |
---|---|---|
checked | Object | Il valore selezionato per la convalida dei dati della casella di controllo. |
unchecked | Object | Il valore non selezionato per la convalida dei dati della casella di controllo. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove Checkboxes()
Rimuove tutte le caselle di controllo dall'intervallo. Cancella la convalida dei dati di ogni cella e, inoltre, ne cancella il valore se la cella contiene il valore selezionato o deselezionato.
const range = SpreadsheetApp.getActive().getRange('A1:B10'); // Inserts checkboxes and sets each cell value to 'no' in the range A1:B10. range.insertCheckboxes('yes', 'no'); const 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(); const 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();
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Background(color)
Imposta il colore di sfondo per ogni Range
nell'elenco dell'intervallo. Il colore è rappresentato in
in notazione CSS; ad esempio, '#ffffff'
o 'white'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setBackground('red');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il codice colore di sfondo nella notazione CSS, ad esempio '#ffffff' o 'white' . Un valore null reimposta il colore. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Background RGB(red, green, blue)
Imposta lo sfondo sul colore RGB specificato. Si tratta di un wrapper pratico per una chiamata set
.
const sheet = SpreadsheetApp.getActiveSheet(); const 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. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Border(top, left, bottom, right, vertical, horizontal)
Imposta la proprietà bordo per ogni Range
nell'elenco dell'intervallo. I valori validi sono
true
(on), false
(off) e null
(no change).
const sheet = SpreadsheetApp.getActiveSheet(); const 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, null per nessuna modifica. |
left | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
bottom | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
right | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
vertical | Boolean | true per i bordi verticali interni, false per nessun bordo, null per nessuna modifica. |
horizontal | Boolean | true per i bordi orizzontali interni, false per nessuno, null per nessuna modifica. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Border(top, left, bottom, right, vertical, horizontal, color, style)
Imposta la proprietà del bordo con il colore e/o lo stile per ogni Range
nell'elenco dell'intervallo.
I valori validi sono true
(on), false
(off) e null
(no change). Il colore è rappresentato nella notazione CSS, ad esempio '#ffffff'
o 'white'
.
const sheet = SpreadsheetApp.getActiveSheet(); const 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, null per nessuna modifica. |
left | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
bottom | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
right | Boolean | true per il bordo, false per nessuno, null per nessuna modifica. |
vertical | Boolean | true per i bordi verticali interni, false per nessun bordo, 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, ad esempio '#ffffff' o 'white' , null per il colore predefinito (nero). |
style | Border | Lo stile dei bordi, null per lo stile predefinito (continuo). |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Color(color)
Imposta il colore del carattere per ogni Range
nell'elenco dell'intervallo. Il colore è rappresentato nella notazione CSS; ad esempio, '#ffffff'
o 'white'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontColor('red');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del carattere in notazione CSS, ad esempio '#ffffff' o 'white' . Un valore
null reimposta il colore. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Family(fontFamily)
Imposta la famiglia di caratteri per ogni Range
nell'elenco dell'intervallo. La famiglia di caratteri è descritta
da un identificatore di stringa come Arial
o Roboto
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontFamily('Roboto');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
font | String | La famiglia di caratteri da impostare. Un valore null reimposta la famiglia di caratteri. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Line(fontLine)
Imposta lo stile della linea del carattere per ogni Range
nell'elenco dell'intervallo. Le opzioni per gli stili di linea sono 'underline'
, 'line-through'
o 'none'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontLine('line-through');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
font | String | Lo stile della linea del carattere, 'underline' , 'line-through' o
'none' ; un valore null reimposta lo stile della linea del carattere. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Size(size)
Imposta la dimensione del carattere (in punti) per ogni Range
nell'elenco dell'intervallo.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontSize(20);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
size | Integer | Una dimensione del carattere in punti. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Style(fontStyle)
Imposta lo stile del carattere per ogni Range
nell'elenco dell'intervallo. Le opzioni di stile dei caratteri sono
'italic'
o 'normal'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontStyle('italic');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
font | String | Lo stile del carattere, 'italic' o 'normal' . Un valore null reimposta lo stile del carattere. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Font Weight(fontWeight)
Imposta l'intensità del carattere per ogni Range
nell'elenco dell'intervallo. Le opzioni di spessore del carattere sono
'normal'
o 'bold'
.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setFontWeight('bold');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
font | String | Lo spessore del carattere, 'bold' o 'normal' . Un valore null
reimposta lo spessore del carattere. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formula(formula)
Aggiorna la formula per ogni Range
nell'elenco dell'intervallo. La formula indicata deve essere in notazione A1.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A11', 'C11']); rangeList.setFormula('=SUM(B1:B10)');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
formula | String | Una stringa che rappresenta la formula da impostare. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Formula R1C1(formula)
Aggiorna la formula per ogni Range
nell'elenco dell'intervallo. La formula indicata deve essere in notazione R1C1.
const sheet = SpreadsheetApp.getActiveSheet(); const 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 di stringa. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Horizontal Alignment(alignment)
Imposta l'allineamento orizzontale per ogni Range
nell'elenco di intervalli. Le opzioni di allineamento
sono 'left'
, 'center'
o 'right'
.
const sheet = SpreadsheetApp.getActiveSheet(); const 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. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Note(note)
Imposta il testo della nota per ogni Range
nell'elenco dell'intervallo.
const sheet = SpreadsheetApp.getActiveSheet(); const 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. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Number Format(numberFormat)
Imposta il formato numerico o della data per ogni Range
nell'elenco dell'intervallo.
I pattern di formattazione accettati sono descritti nella guida alla formattazione di date e numeri dell'API Fogli.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Always show 3 decimal points for the specified ranges. rangeList.setNumberFormat('0.000');
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | String | Una stringa di formato numerico. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Show Hyperlink(showHyperlink)
Imposta se mostrare o meno i link ipertestuali per ogni Range
nell'elenco dell'intervallo.
const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); // Show hyperlinks for all the ranges. rangeList.setShowHyperlink(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
show | Boolean | Indica se mostrare o meno il link ipertestuale. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Direction(direction)
Imposta la direzione del testo per le celle in ogni Range
nell'elenco dell'intervallo. Se una direzione specificata è null
, la direzione viene dedotta e impostata.
// Sets right-to-left text direction each range in the range list. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
direction | Text | La direzione del testo desiderata. Se null , la direzione viene dedotta prima dell'impostazione. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Text Rotation(degrees)
Imposta le impostazioni di rotazione del testo per le celle di ogni Range
nell'elenco dell'intervallo. L'input corrisponde all'angolo tra l'orientamento del testo standard e l'orientamento desiderato. Un valore di input pari a zero indica che il testo è impostato sull'orientamento standard.
Per la direzione del testo da sinistra a destra, gli angoli positivi sono in senso antiorario, mentre per la direzione da destra a sinistra sono in senso orario.
// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 // degrees. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']); rangeList.setTextRotation(45);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
degrees | Integer | L'angolo desiderato tra l'orientamento standard e l'orientamento desiderato. Per il testo da sinistra a destra, gli angoli positivi sono in senso antiorario. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Value(value)
Imposta il valore per ogni Range
nell'elenco di intervalli. Il valore può essere numerico, stringa,
booleano o data. Se inizia con "=", viene interpretata come formula.
const sheet = SpreadsheetApp.getActiveSheet(); // Set value of 100 to each range in the range list. const rangeList = sheet.getRangeList(['A:A', 'C:C']); rangeList.setValue(100);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
value | Object | Il valore dell'intervallo. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Vertical Alignment(alignment)
Imposta l'allineamento verticale per ogni Range
nell'elenco di intervalli. Le opzioni di allineamento
sono 'top'
, 'middle'
o 'bottom'
.
// Sets the vertical alignment to middle for the list of ranges. const sheet = SpreadsheetApp.getActiveSheet(); const 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. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Vertical Text(isVertical)
Imposta se impilare o meno il testo per le celle di ogni Range
nell'elenco
dell'intervallo. Se il testo è impilato verticalmente, l'impostazione della rotazione del testo in gradi viene ignorata.
// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setVerticalText(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
is | Boolean | Indica se impilare o meno il testo. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Wrap(isWrapEnabled)
Imposta il rientro del testo per ogni Range
nell'elenco di intervalli. Le celle con l'a capo abilitato cambiano dimensione per visualizzare i contenuti completi. Le celle con a capo disattivato vengono visualizzate il più possibile nella cella senza ridimensionarle o suddividerle in più righe.
// Enable text wrap for the list of ranges. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrap(true);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
is | Boolean | Se il testo deve andare a capo o meno. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
set Wrap Strategy(strategy)
Imposta la strategia di a capo del testo per ogni Range
nell'elenco dell'intervallo.
// Sets the list of ranges to use the clip wrap strategy. const sheet = SpreadsheetApp.getActiveSheet(); const rangeList = sheet.getRangeList(['D4', 'B2:C4']); rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strategy | Wrap | La strategia di a capo che preferisci. |
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
trim Whitespace()
Taglia gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella di questo elenco di intervalli. Rimuove tutti gli spazi iniziali e finali dal testo di ogni cella e riduce qualsiasi sottosezione di caratteri di spaziatura rimanenti a un unico spazio.
const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; const range = sheet.getRange('A1:A4'); range.activate(); range.setValues([ ' preceding space', 'following space ', 'two middle spaces', ' =SUM(1,2)', ]); const rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']); rangeList.trimWhitespace(); const values = range.getValues(); // Values are ['preceding space', 'following space', 'two middle spaces', // '=SUM(1,2)']
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo 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()
Imposta lo stato delle caselle di controllo nell'intervallo su "non 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 ranges D4 and E6 to 'unchecked'. const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']); rangeList.uncheck();
Invio
Range
: questo elenco di intervalli, per l'accodamento.
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets