Class RangeList

RangeList

Una raccolta di una o più istanze Range nello stesso foglio. Puoi usare questa classe per applicare operazioni su raccolte di intervalli o celle non adiacenti.

Metodi

MetodoTipo restituitoBreve descrizione
activate()RangeListSeleziona l'elenco di istanze Range.
breakApart()RangeListSuddivide di nuovo 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 "Selezionate".
clear()RangeListCancella l'intervallo di contenuti, i formati e le regole di convalida dei dati per ogni Range nell'elenco di intervalli.
clear(options)RangeListCancella l'intervallo di contenuti, il formato, le regole di convalida dei dati e i commenti, come specificato con le opzioni specificate.
clearContent()RangeListCancella il contenuto di ogni Range nell'elenco degli intervalli, senza modificare 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 di intervalli.
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 le caselle di controllo in ogni cella dell'intervallo, configurata con true per selezionata e false per deselezionata.
insertCheckboxes(checkedValue)RangeListInserisce caselle di controllo in ogni cella dell'intervallo, configurata con un valore personalizzato per selezionata e la stringa vuota per deselezionata.
insertCheckboxes(checkedValue, uncheckedValue)RangeListInserisce caselle di controllo in ogni cella dell'intervallo, configurate con valori personalizzati per gli stati selezionati e non selezionati.
removeCheckboxes()RangeListRimuove tutte le caselle di controllo dall'intervallo.
setBackground(color)RangeListImposta il colore di sfondo per ogni Range nell'elenco di 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 un colore e/o uno 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 di intervalli.
setFontLine(fontLine)RangeListImposta lo stile della linea del carattere per ogni Range nell'elenco dell'intervallo.
setFontSize(size)RangeListImposta la dimensione 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 lo spessore 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)RangeListConsente di impostare il formato numerico o data per ogni Range nell'elenco di intervalli.
setShowHyperlink(showHyperlink)RangeListConsente di stabilire se ogni Range dell'elenco di intervalli deve mostrare o meno i link ipertestuali.
setTextDirection(direction)RangeListImposta la direzione del testo per le celle in ogni Range nell'elenco degli intervalli.
setTextRotation(degrees)RangeListConsente di impostare le impostazioni di rotazione del testo per le celle in ogni Range nell'elenco degli intervalli.
setValue(value)RangeListImposta il valore di ogni Range nell'elenco di intervalli.
setVerticalAlignment(alignment)RangeListImposta l'allineamento verticale per ogni Range nell'elenco degli intervalli.
setVerticalText(isVertical)RangeListConsente di impostare se sovrapporre o meno il testo delle celle per ogni Range nell'elenco dell'intervallo.
setWrap(isWrapEnabled)RangeListImposta il ritorno a capo automatico per ogni Range nell'elenco di intervalli.
setWrapStrategy(strategy)RangeListImposta la strategia di testo a capo per ogni Range nell'elenco di intervalli.
trimWhitespace()RangeListModifica gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella dell'elenco di intervalli.
uncheck()RangeListModifica lo stato delle caselle di controllo nell'intervallo in "Deselezionata".

Documentazione dettagliata

activate()

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

Nota:in questo modo puoi selezionare più intervalli di un numero di intervalli. 

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.activate();

var selection = sheet.getSelection();
// Current cell: B2
var currentCell = selection.getCurrentCell();
// Active range: B2:C4
var activeRange = selection.getActiveRange();
// Active range list: [D4, B2:C4]
var activeRangeList = selection.getActiveRangeList();

Ritorni

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

Suddivide di nuovo tutte le celle unite orizzontalmente o verticalmente contenute nell'elenco degli intervalli in singole celle.

Richiamare questa funzione in un elenco di intervalli equivale a selezionare un insieme di intervalli e la voce di menu Formato > Unisci > Dividi fogli. 

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

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

check()

Modifica lo stato delle caselle di controllo nell'intervallo in "Selezionata". Ignora le celle nell'intervallo che 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'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.check();

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

clear()

Cancella l'intervallo di contenuti, i formati e le regole di convalida dei dati per ogni Range nell'elenco di intervalli. 

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

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

clear(options)

Cancella l'intervallo di contenuti, il formato, le regole di convalida dei dati e i commenti, come specificato con le opzioni specificate. Per impostazione predefinita, tutti i dati vengono cancellati. 

// The code below clears the contents of the following ranges A:A and C:C in the active sheet,
// but preserves the format, data validation rules, and comments.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.clear({contentsOnly: true});

Parametri

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.
formatOnlyBooleanIndica se cancellare solo il formato. Tieni presente che la cancellazione del formato comporta anche la cancellazione delle regole di convalida dei dati.
validationsOnlyBooleanIndica se cancellare solo le regole di convalida dei dati.
skipFilteredRowsBooleanIndica se evitare di cancellare le righe filtrate.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

clearContent()

Cancella il contenuto di ogni Range nell'elenco degli intervalli, senza modificare la formattazione. 

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

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

clearDataValidations()

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

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

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

clearFormat()

Cancella la formattazione del testo per ogni Range nell'elenco di intervalli.

Questa operazione cancella la formattazione del testo per ogni intervallo, ma non reimposta le regole di formattazione dei numeri. 

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

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

clearNote()

Cancella la nota per ogni Range nell'elenco di intervalli. 

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

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

getRanges()

Restituisce un elenco di una o più istanze Range nello stesso foglio.

Ritorni

Range[]: l'elenco di intervalli.

Autorizzazione

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

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

insertCheckboxes()

Inserisce le caselle di controllo in ogni cella dell'intervallo, configurata con true per selezionata e false per deselezionata. Imposta il valore di tutte le celle dell'intervallo su false. 

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'true' for checked
// and 'false' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to
// 'false'.
rangeList.insertCheckboxes();

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

insertCheckboxes(checkedValue)

Inserisce caselle di controllo in ogni cella dell'intervallo, configurata con un valore personalizzato per selezionata e la stringa vuota per deselezionata. Imposta il valore di ogni cella dell'intervallo sulla stringa vuota. 

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and the empty string for unchecked. Also, sets the value of each cell in the ranges D4 and
// E6 to the empty string.
rangeList.insertCheckboxes('yes');

Parametri

NomeTipoDescrizione
checkedValueObjectIl valore selezionato per la convalida dei dati della casella di controllo.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

insertCheckboxes(checkedValue, uncheckedValue)

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

var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);

// Inserts checkboxes into each cell in the ranges D4 and E6 configured with 'yes' for checked
// and 'no' for unchecked. Also, sets the value of each cell in the ranges D4 and E6 to 'no'.
rangeList.insertCheckboxes('yes', 'no');

Parametri

NomeTipoDescrizione
checkedValueObjectIl valore selezionato per la convalida dei dati della casella di controllo.
uncheckedValueObjectIl valore deselezionato per la convalida dei dati della casella di controllo.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

removeCheckboxes()

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

var range = SpreadsheetApp.getActive().getRange('A1:B10');

// Inserts checkboxes and sets each cell value to 'no' in the range A1:B10.
range.insertCheckboxes('yes', 'no');

var rangeList1 = SpreadsheetApp.getActive().getRangeList(['A1', 'A3']);
rangeList1.setValue('yes');
// Removes the checkbox data validation in cells A1 and A3 and clears their value.
rangeList1.removeCheckboxes();

var rangeList2 = SpreadsheetApp.getActive().getRangeList(['A5', 'A7']);
rangeList2.setValue('random');
// Removes the checkbox data validation in cells A5 and A7 but does not clear their value.
rangeList2.removeCheckboxes();

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setBackground(color)

Imposta il colore di sfondo per ogni Range nell'elenco di intervalli. Il colore è rappresentato nella notazione CSS, ad esempio '#ffffff' o 'white'. 

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

Parametri

NomeTipoDescrizione
colorStringIl codice del colore di sfondo nella notazione CSS, come '#ffffff' o 'white'; un valore null reimposta il colore.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setBackgroundRGB(red, green, blue)

Imposta lo sfondo sul colore RGB specificato. Questo è un wrapper di convenienza per una chiamata setBackground(color). 

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
// Sets the background to red for each range in the range list.
rangeList.setBackgroundRGB(255, 0, 0);

Parametri

NomeTipoDescrizione
redIntegerIl valore rosso in notazione RGB.
greenIntegerIl valore verde in notazione RGB.
blueIntegerIl valore blu in notazione RGB.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setBorder(top, left, bottom, right, vertical, horizontal)

Imposta la proprietà del bordo per ogni Range nell'elenco di intervalli. I valori validi sono true (on), false (off) e null (nessuna modifica). 

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom of the ranges A2:B4 and C1:D4, but leaves the left and
// right unchanged.
rangeList.setBorder(true, null, true, null, false, false);

Parametri

NomeTipoDescrizione
topBooleantrue per il bordo, false per nessuno e null per nessuna modifica.
leftBooleantrue per il bordo, false per nessuno e null per nessuna modifica.
bottomBooleantrue per il bordo, false per nessuno e null per nessuna modifica.
rightBooleantrue per il bordo, false per nessuno e 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.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setBorder(top, left, bottom, right, vertical, horizontal, color, style)

Imposta la proprietà del bordo con un colore e/o uno stile per ogni Range nell'elenco dell'intervallo. I valori validi sono true (on), false (off) e null (nessuna modifica). Il colore è rappresentato nella notazione CSS, ad esempio '#ffffff' o 'white'. 

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A2:B4', 'C1:D4']);
// Sets borders on the top and bottom, but leaves the left and right unchanged of the ranges
// A2:B4 and C1:D4. Also sets the color to 'red', and the border to 'DASHED'.
rangeList.setBorder(
    true, null, true, null, false, false, 'red', SpreadsheetApp.BorderStyle.DASHED);

Parametri

NomeTipoDescrizione
topBooleantrue per il bordo, false per nessuno e null per nessuna modifica.
leftBooleantrue per il bordo, false per nessuno e null per nessuna modifica.
bottomBooleantrue per il bordo, false per nessuno e null per nessuna modifica.
rightBooleantrue per il bordo, false per nessuno e 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 come '#ffffff' o 'white', null per il colore predefinito (nero).
styleBorderStyleLo stile dei bordi, null per lo stile predefinito (solido).

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setFontColor(color)

Imposta il colore del carattere per ogni Range nell'elenco dell'intervallo. Il colore è rappresentato nella notazione CSS, ad esempio, '#ffffff' o 'white'. 

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

Parametri

NomeTipoDescrizione
colorStringIl colore del carattere nella notazione CSS, come '#ffffff' o 'white'; un valore null reimposta il colore.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setFontFamily(fontFamily)

Imposta la famiglia di caratteri per ogni Range nell'elenco di intervalli. La famiglia di caratteri è descritta da un identificatore stringa come Arial o Roboto. 

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setFontLine(fontLine)

Imposta lo stile della linea del carattere per ogni Range nell'elenco dell'intervallo. Le opzioni per gli stili della linea sono 'underline', 'line-through' o 'none'. 

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setFontSize(size)

Imposta la dimensione carattere (in punti) per ogni Range nell'elenco dell'intervallo. 

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

Parametri

NomeTipoDescrizione
sizeIntegerLa dimensione in punti del carattere.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setFontStyle(fontStyle)

Imposta lo stile del carattere per ogni Range nell'elenco dell'intervallo. Le opzioni di stile del carattere sono 'italic' o 'normal'. 

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setFontWeight(fontWeight)

Imposta lo spessore del carattere per ogni Range nell'elenco dell'intervallo. Le opzioni relative allo spessore del carattere sono 'normal' o 'bold'. 

var sheet = SpreadsheetApp.getActiveSheet();
var 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.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setFormula(formula)

Aggiorna la formula per ogni Range nell'elenco dell'intervallo. La formula deve essere in notazione A1. 

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
rangeList.setFormula('=SUM(B1:B10)');

Parametri

NomeTipoDescrizione
formulaStringUna stringa che rappresenta la formula da impostare.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setFormulaR1C1(formula)

Aggiorna la formula per ogni Range nell'elenco dell'intervallo. La formula data deve essere in notazione R1C1. 

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A11', 'C11']);
// This sets the formula to be the sum of the 3 rows above B5
rangeList.setFormulaR1C1('=SUM(R[-3]C[0]:R[-1]C[0])');

Parametri

NomeTipoDescrizione
formulaStringUna formula stringa.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setHorizontalAlignment(alignment)

Imposta l'allineamento orizzontale per ogni Range nell'elenco di intervalli. Le opzioni di allineamento sono 'left', 'center' o 'right'. 

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

Parametri

NomeTipoDescrizione
alignmentStringL'allineamento, 'left', 'center' o 'normal'; un valore null reimposta l'allineamento.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setNote(note)

Imposta il testo della nota per ogni Range nell'elenco dell'intervallo. 

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setNote('This is a note');

Parametri

NomeTipoDescrizione
noteStringIl testo della nota da impostare; un valore null rimuove la nota.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setNumberFormat(numberFormat)

Consente di impostare il formato numerico o data per ogni Range nell'elenco di intervalli.

I modelli di formattazione accettati sono descritti nella Guida alla formattazione di date e numeri dell'API Fogli. 

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Always show 3 decimal points for the specified ranges.
rangeList.setNumberFormat('0.000');

Parametri

NomeTipoDescrizione
numberFormatStringUna stringa di formato numerico.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

Consente di stabilire se ogni Range dell'elenco di intervalli deve mostrare o meno i link ipertestuali. 

var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
// Show hyperlinks for all the ranges.
rangeList.setShowHyperlink(true);

Parametri

NomeTipoDescrizione
showHyperlinkBooleanIndica se mostrare o meno il link ipertestuale.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setTextDirection(direction)

Imposta la direzione del testo per le celle in ogni Range nell'elenco degli intervalli. Se una direzione specificata è null, la direzione viene dedotta e quindi impostata. 

// Sets right-to-left text direction each range in the range list.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextDirection(SpreadsheetApp.TextDirection.RIGHT_TO_LEFT);

Parametri

NomeTipoDescrizione
directionTextDirectionLa direzione del testo desiderata; se null la direzione viene dedotta prima dell'impostazione.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setTextRotation(degrees)

Consente di impostare le impostazioni di rotazione del testo per le celle in ogni Range nell'elenco degli intervalli. L'input corrisponde all'angolo tra l'orientamento standard del testo e l'orientamento desiderato. Un valore 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 da destra a sinistra sono in senso orario. 

// Sets the cells in the ranges A1:A10 and C1:C10 to have text rotated up 45 degrees.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['A1:A10', 'C1:C10']);
rangeList.setTextRotation(45);

Parametri

NomeTipoDescrizione
degreesIntegerL'angolo desiderato tra l'orientamento standard e quello desiderato. Per il testo da sinistra a destra, gli angoli positivi sono orientati in senso antiorario.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setValue(value)

Imposta il valore di ogni Range nell'elenco di intervalli. Il valore può essere numerico, stringa, booleano o data. Se inizia con "=", viene interpretato come una formula. 

var sheet = SpreadsheetApp.getActiveSheet();
// Set value of 100 to each range in the range list.
var rangeList = sheet.getRangeList(['A:A', 'C:C']);
rangeList.setValue(100);

Parametri

NomeTipoDescrizione
valueObjectIl valore dell'intervallo.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setVerticalAlignment(alignment)

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

// Sets the vertical alignment to middle for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalAlignment("middle");

Parametri

NomeTipoDescrizione
alignmentStringL'allineamento, 'top', 'middle' o 'bottom'; un valore null reimposta l'allineamento.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setVerticalText(isVertical)

Consente di impostare se sovrapporre o meno il testo delle celle per ogni Range nell'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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setVerticalText(true);

Parametri

NomeTipoDescrizione
isVerticalBooleanIndica se sovrapporre o meno il testo.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setWrap(isWrapEnabled)

Imposta il ritorno a capo automatico per ogni Range nell'elenco di intervalli. Le celle in cui è abilitato il wrapping vengono ridimensionate per visualizzare il contenuto completo. Le celle con wrapping disattivato vengono visualizzate il più possibile nella cella senza ridimensionare o eseguire su più righe. 

// Enable text wrap for the list of ranges.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrap(true);

Parametri

NomeTipoDescrizione
isWrapEnabledBooleanIndica se mandare a capo o meno il testo.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

setWrapStrategy(strategy)

Imposta la strategia di testo a capo per ogni Range nell'elenco di intervalli. 

// Sets the list of ranges to use the clip wrap strategy.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeList = sheet.getRangeList(['D4', 'B2:C4']);
rangeList.setWrapStrategy(SpreadsheetApp.WrapStrategy.CLIP);

Parametri

NomeTipoDescrizione
strategyWrapStrategyLa strategia di wrapping desiderata.

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

trimWhitespace()

Modifica gli spazi vuoti (ad esempio spazi, tabulazioni o nuove righe) in ogni cella dell'elenco di intervalli. Rimuove gli spazi vuoti all'inizio e alla fine del testo di ogni cella e riduce a un unico spazio eventuali sottosequenze di spazi vuoti rimanenti. 

var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
var range = sheet.getRange('A1:A4');
range.activate();
range.setValues(
    [' preceding space', 'following space ', 'two  middle  spaces', '   =SUM(1,2)']);

var rangeList = sheet.getRangeList(['A1', 'A2', 'A3', 'A4']);
rangeList.trimWhitespace();

var values = range.getValues();
// Values are ['preceding space', 'following space', 'two middle spaces', '=SUM(1,2)']

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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

Vedi anche

uncheck()

Modifica lo stato delle caselle di controllo nell'intervallo su "Deselezionata". 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 'unchecked'.
var rangeList = SpreadsheetApp.getActive().getRangeList(['D4', 'E6']);
rangeList.uncheck();

Ritorni

RangeList: elenco di questo intervallo, per il concatenamento.

Autorizzazione

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

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