Questa pagina è stata tradotta dall'API Cloud Translation.

Class RangeList

Una raccolta di una o più istanze Range nello stesso foglio. Puoi utilizzare questo corso per applicare operazioni a raccolte di celle o intervalli non adiacenti.

Metodi

Metodo	Tipo restituito	Breve descrizione
`activate()`	`RangeList`	Seleziona l'elenco di istanze `Range`.
`breakApart()`	`RangeList`	Suddividi tutte le celle unite orizzontalmente o verticalmente all'interno dell'elenco di intervalli in le singole celle.
`check()`	`RangeList`	Modifica lo stato delle caselle di controllo nell'intervallo in "selezionata".
`clear()`	`RangeList`	Cancella l'intervallo di contenuti, formati e regole di convalida dei dati per ogni `Range` in l'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 offerte.
`clearContent()`	`RangeList`	Cancella i contenuti di ogni `Range` nell'elenco di intervalli, lasciando inalterata la formattazione.
`clearDataValidations()`	`RangeList`	Cancella le regole di convalida dei dati per ogni `Range` nell'elenco degli 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, configurate con `true` per le caselle selezionate e `false` per deselezionato.
`insertCheckboxes(checkedValue)`	`RangeList`	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)`	`RangeList`	Inserisce le caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per le caselle selezionate e gli stati 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 dell'intervallo.
`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 dell'intervallo.
`setBorder(top, left, bottom, right, vertical, horizontal, color, style)`	`RangeList`	Imposta la proprietà del bordo con il colore e/o lo 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 del 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 degli intervalli.
`setFormulaR1C1(formula)`	`RangeList`	Aggiorna la formula per ogni `Range` nell'elenco degli intervalli.
`setHorizontalAlignment(alignment)`	`RangeList`	Imposta l'allineamento orizzontale per ogni `Range` nell'elenco dell'intervallo.
`setNote(note)`	`RangeList`	Imposta il testo della nota per ogni `Range` nell'elenco dell'intervallo.
`setNumberFormat(numberFormat)`	`RangeList`	Imposta il numero o il formato della data per ogni `Range` nell'elenco dell'intervallo.
`setShowHyperlink(showHyperlink)`	`RangeList`	Consente di stabilire se ogni `Range` nell'elenco dell'intervallo deve mostrare o meno i link ipertestuali.
`setTextDirection(direction)`	`RangeList`	Imposta la direzione del testo delle celle in ogni `Range` nell'elenco dell'intervallo.
`setTextRotation(degrees)`	`RangeList`	Consente di configurare le impostazioni di rotazione del testo per le celle di ogni `Range` nell'elenco dell'intervallo.
`setValue(value)`	`RangeList`	Imposta il valore per ogni `Range` nell'elenco dell'intervallo.
`setVerticalAlignment(alignment)`	`RangeList`	Imposta l'allineamento verticale per ogni `Range` nell'elenco dell'intervallo.
`setVerticalText(isVertical)`	`RangeList`	Consente di impostare se sovrapporre o meno il testo delle celle per ogni `Range` nell'intervallo dall'elenco di lettura.
`setWrap(isWrapEnabled)`	`RangeList`	Imposta la funzione di testo a capo per ogni `Range` nell'elenco di intervalli.
`setWrapStrategy(strategy)`	`RangeList`	Imposta la strategia di testo a capo per ogni `Range` nell'elenco dell'intervallo.
`trimWhitespace()`	`RangeList`	Taglia 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 è possibile selezionare più intervalli contemporaneamente.

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

Invio

RangeList: l'elenco degli 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()`

Suddividi tutte le celle unite orizzontalmente o verticalmente all'interno dell'elenco di intervalli in le singole celle.

Chiamare questa funzione in un elenco di intervalli equivale a selezionare un insieme di intervalli e selezionando Formato > Unisci > Voce di menu Dividi Fogli.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.breakApart();

Invio

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 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'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

Invio

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, formati e regole di convalida dei dati per ogni Range in l'elenco di intervalli.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear();

Invio

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

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 i contenuti di ogni Range nell'elenco di intervalli, lasciando inalterata la formattazione.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearContent();

Invio

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 degli intervalli.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearDataValidations();

Invio

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.

In questo modo viene cancellata la formattazione del testo di ogni intervallo, ma non vengono reimpostate le regole di formattazione del numero.

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clearFormat();

Invio

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

Invio

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.

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

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

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

Invio

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

Invio

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

Invio

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 dell'intervallo. Il colore è rappresentato in in 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 in notazione CSS come `'#ffffff'` o `'white'`; un valore `null` reimposta il colore.

Invio

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. Si tratta di un pratico wrapper 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.

Invio

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 dell'intervallo. 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, `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

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 il colore e/o lo stile per ogni Range nell'elenco dell'intervallo. I valori validi sono true (on), false (off) e null (nessuna modifica). Il colore è rappresentati in 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, `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`	Il colore del bordo in notazione CSS come `'#ffffff'` o `'white'`, `null` per il colore predefinito (nero).
`style`	`BorderStyle`	Lo stile per i bordi, `null` per lo stile predefinito (solido).

Invio

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 in CSS encoder-decoder; 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 Il valore `null` reimposta il colore.

Invio

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

Invio

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 degli stili di 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.

Invio

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 del 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`	Una dimensione in punto del carattere.

Invio

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 per lo 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`	Stile del carattere, `'italic'` o `'normal'`; `null` reimposta lo stile del carattere.

Invio

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 per lo 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'`. `null` reimposta lo spessore del carattere.

Invio

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 degli intervalli. La formula specificata deve essere in formato 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.

Invio

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 degli intervalli. La formula specificata deve essere in formato la 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.

Invio

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 dell'intervallo. 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 Il valore `null` reimposta l'allineamento.

Invio

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.

Invio

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

Imposta il numero o il formato 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.

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 in formato numerico.

Invio

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

Invio

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 delle celle in ogni Range nell'elenco dell'intervallo. Se la direzione specificata è null, la direzione viene dedotta e poi 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'ambientazione.

Invio

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 configurare le impostazioni di rotazione del testo per le celle di ogni Range nell'elenco dell'intervallo. La l'input corrisponde all'angolo tra l'orientamento standard del testo e quello desiderato orientamento. Il valore 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'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

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 per ogni Range nell'elenco dell'intervallo. Il valore può essere numerico, stringa un valore booleano o una data. Se inizia con "=" viene interpretata 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.

Invio

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 dell'intervallo. 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 Il valore `null` reimposta l'allineamento.

Invio

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'intervallo dall'elenco di lettura. 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.
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.

Invio

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 la funzione di testo a capo per ogni Range nell'elenco di intervalli. Ridimensionamento delle celle in cui è abilitato il wrapping per visualizzarne i contenuti completi. Le celle con testo a capo disattivato vengono visualizzate il più possibile nella cella senza ridimensionarli o eseguire la visualizzazione 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.

Invio

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

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

Invio

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

Taglia 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 eventuali sottosequenze di caratteri di spazio vuoto 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)']);

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

Invio

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

Range.trimWhitespace()

`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 ranges D4 and E6 to 'unchecked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

Invio

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