Class RangeList

Elenco intervalli

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

Documentazione dettagliata

activate()

Seleziona l'elenco delle istanze Range. L'ultimo intervallo nell'elenco è impostato come active range.

Nota:in questo modo puoi 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();

Indietro

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

Dividi nuovamente tutte le celle unite orizzontalmente o verticalmente contenute nell'elenco degli intervalli in singole celle.

Chiamare questa funzione su un elenco di intervalli equivale a selezionare un insieme di intervalli e selezionare la voce di menu Formato > Unisci > Dividi di Fogli. 

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

Indietro

RangeList: questo elenco di intervalli, 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 "Selezionato". Ignora le celle nell'intervallo che attualmente non contengono il valore selezionato o deselezionato configurato. 

// Changes the state of cells which currently contain either the checked or
// unchecked value configured in the ranges D4 and E6 to 'checked'.
const rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

Indietro

RangeList: questo elenco di intervalli, 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 nell'elenco degli intervalli. 

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

Indietro

RangeList: questo elenco di intervalli, 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, formato, regole di convalida dei dati e 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
commentsOnlyBooleanSpecifica se cancellare solo i commenti.
contentsOnlyBooleanSe cancellare solo i contenuti.
formatOnlyBooleanSe cancellare solo il formato; tieni presente che la cancellazione del formato cancella anche le regole di convalida dei dati.
validationsOnlyBooleanSe cancellare solo le regole di convalida dei dati.
skipFilteredRowsBooleanIndica se evitare di cancellare le righe filtrate.

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli, lasciando intatta la formattazione. 

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

Indietro

RangeList: questo elenco di intervalli, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

clearDataValidations()

Cancella le regole di convalida dei dati per ogni Range nell'elenco di intervalli. 

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

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli.

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

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli. 

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

Indietro

RangeList: questo elenco di intervalli, 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 di Range nello stesso foglio.

Indietro

Range[]: l'elenco degli 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 le caselle selezionate e false per quelle non selezionate. 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();

Indietro

RangeList: questo elenco di intervalli, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertCheckboxes(checkedValue)

Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con un valore personalizzato per la casella selezionata e la stringa vuota per la casella non selezionata. Imposta il valore di ogni cella nell'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.

Indietro

RangeList: questo elenco di intervalli, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

insertCheckboxes(checkedValue, uncheckedValue)

Inserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionato e non selezionato. Imposta il valore di ogni cella nell'intervallo sul valore personalizzato non selezionato. 

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.

Indietro

RangeList: questo elenco di intervalli, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

removeCheckboxes()

Rimuove tutte le caselle di controllo dall'intervallo. Cancella la convalida dei dati di ogni cella e cancella anche il relativo valore se la cella contiene il valore selezionato o deselezionato. 

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

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli. Il colore è rappresentato nella 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.

Indietro

RangeList: questo elenco di intervalli, 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 wrapper di convenienza 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 nella notazione RGB.
greenIntegerIl valore del verde nella notazione RGB.
blueIntegerIl valore del blu nella notazione RGB.

Indietro

RangeList: questo elenco di intervalli, 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). 

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 nessuno, null per nessuna modifica.
horizontalBooleantrue per i bordi orizzontali interni, false per nessuno, null per nessuna modifica.

Indietro

RangeList: questo elenco di intervalli, 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 colore e/o stile per ogni Range nell'elenco degli intervalli. I valori validi sono true (on), false (off) e null (nessuna modifica). 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 nessuno, 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).

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli. 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 nella notazione CSS, ad esempio '#ffffff' o 'white'; un valore null reimposta il colore.

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli. La famiglia di caratteri è descritta da una stringa identificatore 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.

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli. Le opzioni di stile della 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.

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli. 

const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setFontSize(20);

Parametri

NomeTipoDescrizione
sizeIntegerUna dimensione del carattere in punti.

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli. Le opzioni di stile del carattere 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.

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli. Le opzioni per lo 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.

Indietro

RangeList: questo elenco di intervalli, 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 di intervalli. La formula fornita 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.

Indietro

RangeList: questo elenco di intervalli, 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 di intervalli. La formula fornita 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.

Indietro

RangeList: questo elenco di intervalli, 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 degli 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.

Indietro

RangeList: questo elenco di intervalli, 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 di intervalli. 

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.

Indietro

RangeList: questo elenco di intervalli, 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 formato di numero o data per ogni Range nell'elenco degli intervalli.

I pattern di formattazione accettati sono descritti nella guida alla formattazione di date e numeri dell'API Sheets. 

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.

Indietro

RangeList: questo elenco di intervalli, 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

Imposta se mostrare o meno i link ipertestuali per ogni Range nell'elenco degli intervalli. 

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.

Indietro

RangeList: questo elenco di intervalli, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setTextDirection(direction)

Imposta la direzione del testo per le celle di ogni Range nell'elenco di intervalli. Se una direzione specificata è null, la direzione viene dedotta e poi 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.

Indietro

RangeList: questo elenco di intervalli, 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)

Imposta le impostazioni di rotazione del testo per le celle di ogni Range nell'elenco di intervalli. L'input corrisponde all'angolo tra l'orientamento standard del testo e l'orientamento desiderato. Un 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 quello desiderato. Per il testo da sinistra a destra, gli angoli positivi sono in senso antiorario.

Indietro

RangeList: questo elenco di intervalli, 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 degli intervalli. Il valore può essere numerico, stringa, booleano o data. Se inizia con "=", viene interpretato come una 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.

Indietro

RangeList: questo elenco di intervalli, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setVerticalAlignment(alignment)

Imposta l'allineamento verticale per ogni Range nell'elenco degli intervalli. Le opzioni di allineamento sono 'top', 'middle' o 'bottom'. 

// Sets the vertical alignment to middle for the list of ranges.
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.

Indietro

RangeList: questo elenco di intervalli, 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)

Imposta se impilare o meno il testo delle celle per ogni Range nell'elenco dell'intervallo. Se il testo è impilato verticalmente, l'impostazione di rotazione del testo in gradi viene ignorata. 

// Sets all cell's in ranges D4 and B2:D4 to have vertically stacked text.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

Parametri

NomeTipoDescrizione
isVerticalBooleanSe impilare o meno il testo.

Indietro

RangeList: questo elenco di intervalli, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setWrap(isWrapEnabled)

Imposta il ritorno a capo per ogni Range nell'elenco degli intervalli. Le celle con l'opzione A capo abilitata vengono ridimensionate per visualizzare l'intero contenuto. Le celle con il ritorno a capo disattivato visualizzano il maggior numero possibile di caratteri nella cella senza ridimensionamento o suddivisione su 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 andare a capo o meno.

Indietro

RangeList: questo elenco di intervalli, 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 ritorno a capo del testo per ogni Range nell'elenco degli intervalli. 

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

Indietro

RangeList: questo elenco di intervalli, 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()

Elimina gli spazi vuoti (come spazi, tabulazioni o nuove righe) in ogni cella di questo elenco di intervalli. Rimuove tutti gli spazi vuoti dall'inizio e dalla fine del testo di ogni cella e riduce qualsiasi sequenza di spazi vuoti rimanenti a un singolo 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)']

Indietro

RangeList: questo elenco di intervalli, per il concatenamento.

Autorizzazione

Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

Vedi anche

uncheck()

Modifica lo stato delle caselle di controllo nell'intervallo in "non selezionato". Ignora le celle nell'intervallo che attualmente non contengono il valore selezionato o non selezionato 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();

Indietro

RangeList: questo elenco di intervalli, 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