Class RangeList

IntervalloElenco

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

MetodoTipo restituitoBreve descrizione
activate()RangeListSeleziona l'elenco di istanze Range.
breakApart()RangeListSuddividi nuovamente tutte le celle unite orizzontalmente o verticalmente contenute nell'elenco di intervalli in singole celle.
check()RangeListModifica lo stato delle caselle di controllo nell'intervallo in "selezionata".
clear()RangeListCancella l'intervallo di contenuti, formati e regole di convalida dei dati per ogni Range nell'elenco degli intervalli.
clear(options)RangeListCancella l'intervallo di contenuti, il formato, le regole di convalida dei dati e i commenti, come specificato con le opzioni indicate.
clearContent()RangeListCancella i contenuti di ogni Range nell'elenco dell'intervallo, lasciando invariata la formattazione.
clearDataValidations()RangeListCancella le regole di convalida dei dati per ogni Range nell'elenco dell'intervallo.
clearFormat()RangeListCancella la formattazione del testo per ogni Range nell'elenco dell'intervallo.
clearNote()RangeListCancella la nota per ogni Range nell'elenco di intervalli.
getRanges()Range[]Restituisce un elenco di una o più istanze Range nello stesso foglio.
insertCheckboxes()RangeListInserisce caselle di controllo in ogni cella dell'intervallo, configurate con true per la selezione e false per la mancata selezione.
insertCheckboxes(checkedValue)RangeListInserisce 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)RangeListInserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e deselezionati.
removeCheckboxes()RangeListRimuove tutte le caselle di controllo dall'intervallo.
setBackground(color)RangeListImposta il colore di sfondo per ogni Range nell'elenco dell'intervallo.
setBackgroundRGB(red, green, blue)RangeListImposta lo sfondo sul colore RGB specificato.
setBorder(top, left, bottom, right, vertical, horizontal)RangeListImposta la proprietà bordo per ogni Range nell'elenco dell'intervallo.
setBorder(top, left, bottom, right, vertical, horizontal, color, style)RangeListImposta la proprietà del bordo con il colore e/o lo stile per ogni Range nell'elenco dell'intervallo.
setFontColor(color)RangeListImposta il colore del carattere per ogni Range nell'elenco dell'intervallo.
setFontFamily(fontFamily)RangeListImposta la famiglia di caratteri per ogni Range nell'elenco dell'intervallo.
setFontLine(fontLine)RangeListImposta lo stile della linea del carattere per ogni Range nell'elenco dell'intervallo.
setFontSize(size)RangeListImposta la dimensione del carattere (in punti) per ogni Range nell'elenco dell'intervallo.
setFontStyle(fontStyle)RangeListImposta lo stile del carattere per ogni Range nell'elenco dell'intervallo.
setFontWeight(fontWeight)RangeListImposta l'intensità del carattere per ogni Range nell'elenco dell'intervallo.
setFormula(formula)RangeListAggiorna la formula per ogni Range nell'elenco dell'intervallo.
setFormulaR1C1(formula)RangeListAggiorna la formula per ogni Range nell'elenco dell'intervallo.
setHorizontalAlignment(alignment)RangeListImposta l'allineamento orizzontale per ogni Range nell'elenco di intervalli.
setNote(note)RangeListImposta il testo della nota per ogni Range nell'elenco dell'intervallo.
setNumberFormat(numberFormat)RangeListImposta il formato numerico o della data per ogni Range nell'elenco dell'intervallo.
setShowHyperlink(showHyperlink)RangeListImposta se mostrare o meno i link ipertestuali per ogni Range nell'elenco dell'intervallo.
setTextDirection(direction)RangeListImposta la direzione del testo per le celle in ogni Range nell'elenco dell'intervallo.
setTextRotation(degrees)RangeListImposta le impostazioni di rotazione del testo per le celle di ogni Range nell'elenco dell'intervallo.
setValue(value)RangeListImposta il valore per ogni Range nell'elenco di intervalli.
setVerticalAlignment(alignment)RangeListImposta l'allineamento verticale per ogni Range nell'elenco di intervalli.
setVerticalText(isVertical)RangeListImposta se impilare o meno il testo per le celle di ogni Range nell'elenco dell'intervallo.
setWrap(isWrapEnabled)RangeListImposta il rientro del testo per ogni Range nell'elenco di intervalli.
setWrapStrategy(strategy)RangeListImposta la strategia di a capo del testo per ogni Range nell'elenco dell'intervallo.
trimWhitespace()RangeListTaglia gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella di questo elenco di intervalli.
uncheck()RangeListImposta 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

NomeTipoDescrizione
optionsObjectUn oggetto JavaScript che specifica i parametri avanzati, come elencato di seguito.

Parametri avanzati

NomeTipoDescrizione
commentsOnlyBooleanIndica se cancellare solo i commenti.
contentsOnlyBooleanIndica se cancellare solo i contenuti.
formatOnlyBooleanSe cancellare solo la formattazione; tieni presente che la cancellazione della formattazione comporta anche l'eliminazione delle regole di convalida dei dati.
validationsOnlyBooleanIndica se cancellare solo le regole di convalida dei dati.
skipFilteredRowsBooleanIndica 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

NomeTipoDescrizione
checkedValueObjectIl 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

NomeTipoDescrizione
checkedValueObjectIl valore selezionato per la convalida dei dati della casella di controllo.
uncheckedValueObjectIl 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

NomeTipoDescrizione
colorStringIl 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

NomeTipoDescrizione
redIntegerIl valore rosso in notazione RGB.
greenIntegerIl valore verde in notazione RGB.
blueIntegerIl 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

NomeTipoDescrizione
topBooleantrue per il bordo, false per nessuno, null per nessuna modifica.
leftBooleantrue per il bordo, false per nessuno, null per nessuna modifica.
bottomBooleantrue per il bordo, false per nessuno, null per nessuna modifica.
rightBooleantrue per il bordo, false per nessuno, null per nessuna modifica.
verticalBooleantrue per i bordi verticali interni, false per nessun bordo, null per nessuna modifica.
horizontalBooleantrue 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

NomeTipoDescrizione
topBooleantrue per il bordo, false per nessuno, null per nessuna modifica.
leftBooleantrue per il bordo, false per nessuno, null per nessuna modifica.
bottomBooleantrue per il bordo, false per nessuno, null per nessuna modifica.
rightBooleantrue per il bordo, false per nessuno, null per nessuna modifica.
verticalBooleantrue per i bordi verticali interni, false per nessun bordo, null per nessuna modifica.
horizontalBooleantrue per i bordi orizzontali interni, false per nessuno, null per nessuna modifica.
colorStringIl colore del bordo nella notazione CSS, ad esempio '#ffffff' o 'white', null per il colore predefinito (nero).
styleBorderStyleLo 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

NomeTipoDescrizione
colorStringIl 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

NomeTipoDescrizione
fontFamilyStringLa 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

NomeTipoDescrizione
fontLineStringLo 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

NomeTipoDescrizione
sizeIntegerUna 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

NomeTipoDescrizione
fontStyleStringLo 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

NomeTipoDescrizione
fontWeightStringLo 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

NomeTipoDescrizione
formulaStringUna 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

NomeTipoDescrizione
formulaStringUna 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

NomeTipoDescrizione
alignmentStringL'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

NomeTipoDescrizione
noteStringIl 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

NomeTipoDescrizione
numberFormatStringUna 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

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

NomeTipoDescrizione
showHyperlinkBooleanIndica 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

NomeTipoDescrizione
directionTextDirectionLa 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

NomeTipoDescrizione
degreesIntegerL'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

NomeTipoDescrizione
valueObjectIl 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

NomeTipoDescrizione
alignmentStringL'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

NomeTipoDescrizione
isVerticalBooleanIndica 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

NomeTipoDescrizione
isWrapEnabledBooleanSe 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

NomeTipoDescrizione
strategyWrapStrategyLa 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

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