Questa pagina è stata tradotta dall'API Cloud Translation.

Class RangeList

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()`	`RangeList`	Seleziona l'elenco di istanze `Range`.
`breakApart()`	`RangeList`	Suddividi nuovamente tutte le celle unite orizzontalmente o verticalmente contenute nell'elenco di intervalli in 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` nell'elenco degli 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 indicate.
`clearContent()`	`RangeList`	Cancella i contenuti di ogni `Range` nell'elenco dell'intervallo, lasciando invariata la formattazione.
`clearDataValidations()`	`RangeList`	Cancella le regole di convalida dei dati per ogni `Range` nell'elenco dell'intervallo.
`clearFormat()`	`RangeList`	Cancella la formattazione del testo per ogni `Range` nell'elenco dell'intervallo.
`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 caselle di controllo in ogni cella dell'intervallo, configurate con `true` per la selezione e `false` per la mancata selezione.
`insertCheckboxes(checkedValue)`	`RangeList`	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.
`insertCheckboxes(checkedValue, uncheckedValue)`	`RangeList`	Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e deselezionati.
`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à 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 dell'intervallo.
`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 l'intensità 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`	Imposta il formato numerico o della data per ogni `Range` nell'elenco dell'intervallo.
`setShowHyperlink(showHyperlink)`	`RangeList`	Imposta se mostrare o meno i link ipertestuali per ogni `Range` nell'elenco dell'intervallo.
`setTextDirection(direction)`	`RangeList`	Imposta la direzione del testo per le celle in ogni `Range` nell'elenco dell'intervallo.
`setTextRotation(degrees)`	`RangeList`	Imposta 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 di intervalli.
`setVerticalAlignment(alignment)`	`RangeList`	Imposta l'allineamento verticale per ogni `Range` nell'elenco di intervalli.
`setVerticalText(isVertical)`	`RangeList`	Imposta se impilare o meno il testo per le celle di ogni `Range` nell'elenco dell'intervallo.
`setWrap(isWrapEnabled)`	`RangeList`	Imposta il rientro del testo per ogni `Range` nell'elenco di intervalli.
`setWrapStrategy(strategy)`	`RangeList`	Imposta la strategia di a capo del testo per ogni `Range` nell'elenco dell'intervallo.
`trimWhitespace()`	`RangeList`	Taglia gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella di questo elenco di intervalli.
`uncheck()`	`RangeList`	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

RangeList: 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

`breakApart()`

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

RangeList: 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

RangeList: 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

RangeList: 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
`commentsOnly`	`Boolean`	Indica se cancellare solo i commenti.
`contentsOnly`	`Boolean`	Indica se cancellare solo i contenuti.
`formatOnly`	`Boolean`	Se cancellare solo la formattazione; tieni presente che la cancellazione della formattazione comporta anche l'eliminazione 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.

Invio

RangeList: 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

`clearContent()`

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

RangeList: 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

`clearDataValidations()`

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

RangeList: 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

`clearFormat()`

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

RangeList: 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

`clearNote()`

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

RangeList: 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

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

RangeList: 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

`insertCheckboxes(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
`checkedValue`	`Object`	Il valore selezionato per la convalida dei dati della casella di controllo.

Invio

RangeList: 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

`insertCheckboxes(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
`checkedValue`	`Object`	Il valore selezionato per la convalida dei dati della casella di controllo.
`uncheckedValue`	`Object`	Il valore non selezionato per la convalida dei dati della casella di controllo.

Invio

RangeList: 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

`removeCheckboxes()`

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

RangeList: 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

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

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

RangeList: 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

`setBackgroundRGB(red, green, blue)`

Imposta lo sfondo sul colore RGB specificato. Si tratta di un wrapper pratico per una chiamata setBackground(color).

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

RangeList: 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

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

RangeList: 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

`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 (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`	`BorderStyle`	Lo stile dei bordi, `null` per lo stile predefinito (continuo).

Invio

RangeList: 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

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

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

RangeList: 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

`setFontFamily(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
`fontFamily`	`String`	La famiglia di caratteri da impostare. Un valore `null` reimposta la famiglia di caratteri.

Invio

RangeList: 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

`setFontLine(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
`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: 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

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

RangeList: 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

`setFontStyle(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
`fontStyle`	`String`	Lo stile del carattere, `'italic'` o `'normal'`. Un valore `null` reimposta lo stile del carattere.

Invio

RangeList: 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

`setFontWeight(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
`fontWeight`	`String`	Lo spessore del carattere, `'bold'` o `'normal'`. Un valore `null` reimposta lo spessore del carattere.

Invio

RangeList: 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

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

RangeList: 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

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

RangeList: 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

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

RangeList: 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

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

RangeList: 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

`setNumberFormat(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
`numberFormat`	`String`	Una stringa di formato numerico.

Invio

RangeList: 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

`setShowHyperlink(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
`showHyperlink`	`Boolean`	Indica se mostrare o meno il link ipertestuale.

Invio

RangeList: 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

`setTextDirection(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`	`TextDirection`	La direzione del testo desiderata. Se `null`, la direzione viene dedotta prima dell'impostazione.

Invio

RangeList: 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

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

RangeList: 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

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

RangeList: 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

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

RangeList: 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

`setVerticalText(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
`isVertical`	`Boolean`	Indica se impilare o meno il testo.

Invio

RangeList: 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

`setWrap(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
`isWrapEnabled`	`Boolean`	Se il testo deve andare a capo o meno.

Invio

RangeList: 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

`setWrapStrategy(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`	`WrapStrategy`	La strategia di a capo che preferisci.

Invio

RangeList: 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

`trimWhitespace()`

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

RangeList: 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

Range.trimWhitespace()

`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

RangeList: 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