Questa pagina è stata tradotta dall'API Cloud Translation.

Class ConditionalFormatRuleBuilder

Strumento per la creazione di regole di formattazione condizionale.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Metodi

Metodo	Tipo restituito	Breve descrizione
`build()`	`ConditionalFormatRule`	Crea una regola di formattazione condizionale dalle impostazioni applicate al generatore.
`copy()`	`ConditionalFormatRuleBuilder`	Restituisce un preset del generatore di regole con le impostazioni di questa regola.
`getBooleanCondition()`	`BooleanCondition`	Recupera le informazioni `BooleanCondition` della regola se questa regola utilizza criteri di condizione booleani.
`getGradientCondition()`	`GradientCondition`	Recupera le informazioni `GradientCondition` della regola, se la regola utilizza criteri di condizione del gradiente.
`getRanges()`	`Range[]`	Recupera gli intervalli a cui viene applicata questa regola di formattazione condizionale.
`setBackground(color)`	`ConditionalFormatRuleBuilder`	Imposta il colore di sfondo per il formato della regola di formattazione condizionale.
`setBackgroundObject(color)`	`ConditionalFormatRuleBuilder`	Imposta il colore di sfondo per il formato della regola di formattazione condizionale.
`setBold(bold)`	`ConditionalFormatRuleBuilder`	Imposta il grassetto del testo per il formato della regola di formattazione condizionale.
`setFontColor(color)`	`ConditionalFormatRuleBuilder`	Imposta il colore del carattere per il formato della regola di formattazione condizionale.
`setFontColorObject(color)`	`ConditionalFormatRuleBuilder`	Imposta il colore del carattere per il formato della regola di formattazione condizionale.
`setGradientMaxpoint(color)`	`ConditionalFormatRuleBuilder`	Cancella il valore massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola.
`setGradientMaxpointObject(color)`	`ConditionalFormatRuleBuilder`	Cancella il valore massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola.
`setGradientMaxpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Imposta i campi del punto massimo del gradiente della regola di formattazione condizionale.
`setGradientMaxpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Imposta i campi del punto massimo del gradiente della regola di formattazione condizionale.
`setGradientMidpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Imposta i campi del punto centrale del gradiente della regola di formattazione condizionale.
`setGradientMidpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Imposta i campi del punto centrale del gradiente della regola di formattazione condizionale.
`setGradientMinpoint(color)`	`ConditionalFormatRuleBuilder`	Cancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola.
`setGradientMinpointObject(color)`	`ConditionalFormatRuleBuilder`	Cancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola.
`setGradientMinpointObjectWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Imposta i campi dei punti minimi del gradiente della regola di formattazione condizionale.
`setGradientMinpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Imposta i campi dei punti minimi del gradiente della regola di formattazione condizionale.
`setItalic(italic)`	`ConditionalFormatRuleBuilder`	Imposta il corsivo del testo per il formato della regola di formattazione condizionale.
`setRanges(ranges)`	`ConditionalFormatRuleBuilder`	Imposta uno o più intervalli a cui viene applicata questa regola di formattazione condizionale.
`setStrikethrough(strikethrough)`	`ConditionalFormatRuleBuilder`	Imposta il testo barrato per il formato della regola di formattazione condizionale.
`setUnderline(underline)`	`ConditionalFormatRuleBuilder`	Imposta il testo di sottolineatura per il formato della regola di formattazione condizionale.
`whenCellEmpty()`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando la cella è vuota.
`whenCellNotEmpty()`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando la cella non è vuota.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è successiva al valore specificato.
`whenDateAfter(date)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è successiva alla data relativa specificata.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente alla data specificata.
`whenDateBefore(date)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente alla data relativa specificata.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è uguale alla data specificata.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è uguale alla data relativa specificata.
`whenFormulaSatisfied(formula)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando la formula specificata restituisce `true`.
`whenNumberBetween(start, end)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero rientra o rientra tra due valori specificati.
`whenNumberEqualTo(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è uguale al valore specificato.
`whenNumberGreaterThan(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è maggiore del valore specificato.
`whenNumberGreaterThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è maggiore o uguale al valore specificato.
`whenNumberLessThan(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è inferiore al valore specificato.
`whenNumberLessThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è inferiore o uguale al valore specificato.
`whenNumberNotBetween(start, end)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero non rientra tra i due valori specificati e non corrisponde a nessuno dei due.
`whenNumberNotEqualTo(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che si attivi quando un numero non è uguale al valore specificato.
`whenTextContains(text)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando l'input contiene il valore specificato.
`whenTextDoesNotContain(text)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando l'input non contiene il valore specificato.
`whenTextEndsWith(text)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando l'input termina con il valore specificato.
`whenTextEqualTo(text)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che si attivi quando l'input è uguale al valore specificato.
`whenTextStartsWith(text)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando l'input inizia con il valore specificato.
`withCriteria(criteria, args)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale su criteri definiti dai valori `BooleanCriteria`, recuperati in genere da `criteria` e `arguments` di una regola esistente.

Documentazione dettagliata

`build()`

Crea una regola di formattazione condizionale dalle impostazioni applicate al generatore.

Ritorni

ConditionalFormatRule: una rappresentazione della regola di formattazione condizionale

`copy()`

Restituisce un preset del generatore di regole con le impostazioni di questa regola.

Ritorni

ConditionalFormatRuleBuilder: un generatore basato sulle impostazioni di questa regola

`getBooleanCondition()`

Recupera le informazioni BooleanCondition della regola se questa regola utilizza criteri di condizione booleani. In caso contrario, restituisce null.

// Log the boolean criteria type of the first conditional format rules of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

Ritorni

BooleanCondition: l'oggetto condizione booleano o null se la regola non utilizza una condizione booleana.

`getGradientCondition()`

Recupera le informazioni GradientCondition della regola, se la regola utilizza criteri di condizione del gradiente. In caso contrario, restituisce null.

// Log the gradient minimum color of the first conditional format rule of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

Ritorni

GradientCondition: l'oggetto della condizione del gradiente o null se la regola non utilizza una condizione del gradiente.

`getRanges()`

Recupera gli intervalli a cui viene applicata questa regola di formattazione condizionale.

// Log each range of the first conditional format rule of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var ranges = rule.getRanges();
for (var i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

Ritorni

Range[]: gli intervalli a cui viene applicata la regola di formattazione condizionale.

`setBackground(color)`

Imposta il colore di sfondo per il formato della regola di formattazione condizionale. Se passi in null rimuove l'impostazione del formato del colore di sfondo dalla regola.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`String`	Il colore desiderato o il colore `null` da cancellare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setBackgroundObject(color)`

Imposta il colore di sfondo per il formato della regola di formattazione condizionale. Se passi in null rimuove l'impostazione del formato del colore di sfondo dalla regola.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color to theme background color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`Color`	L'oggetto colore desiderato o il `null` da cancellare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento per il concatenamento.

`setBold(bold)`

Imposta il grassetto del testo per il formato della regola di formattazione condizionale. Se bold è true, la regola applica il grassetto al testo se la condizione è soddisfatta; se false, la regola rimuove tutti i caratteri in grassetto esistenti se la condizione è soddisfatta. Se trasmetti null, l'impostazione del formato in grassetto viene rimossa dalla regola.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text bold if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBold(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`bold`	`Boolean`	Indica se il testo deve essere in grassetto o meno se la condizione del formato è soddisfatta; `null` rimuove questa impostazione.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setFontColor(color)`

Imposta il colore del carattere per il formato della regola di formattazione condizionale. Se trasmetti null, l'impostazione del formato del colore del carattere viene rimossa dalla regola.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to red if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`String`	Il colore desiderato o il colore `null` da cancellare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setFontColorObject(color)`

Imposta il colore del carattere per il formato della regola di formattazione condizionale. Se trasmetti null, l'impostazione del formato del colore del carattere viene rimossa dalla regola.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font
// color to theme text color if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor(color)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`Color`	L'oggetto colore desiderato o il `null` da cancellare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento per il concatenamento.

`setGradientMaxpoint(color)`

Cancella il valore massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola. Imposta inoltre il punto massimo del gradiente sul colore di input.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`String`	Il colore punto massimo da impostare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setGradientMaxpointObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`Color`	L'oggetto colore maxpoint da impostare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento per il concatenamento.

`setGradientMaxpointObjectWithValue(color, type, value)`

Imposta i campi del punto massimo del gradiente della regola di formattazione condizionale.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1, accent 2 to accent 3 colors, based on their
// values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`Color`	Il colore punto massimo da impostare.
`type`	`InterpolationType`	Il tipo di interpolazione del punto massimo da impostare.
`value`	`String`	Il valore maxpoint da impostare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento per il concatenamento.

`setGradientMaxpointWithValue(color, type, value)`

Imposta i campi del punto massimo del gradiente della regola di formattazione condizionale.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`String`	Il colore punto massimo da impostare.
`type`	`InterpolationType`	Il tipo di interpolazione del punto massimo da impostare.
`value`	`String`	Il valore maxpoint da impostare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setGradientMidpointObjectWithValue(color, type, value)`

Imposta i campi del punto centrale del gradiente della regola di formattazione condizionale. Cancella tutti i campi del punto centrale se il tipo di interpolazione passato è null.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`Color`	Il colore del punto medio da impostare.
`type`	`InterpolationType`	Il tipo di interpolazione del punto medio da impostare o `null` per cancellare.
`value`	`String`	Il valore del punto medio da impostare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento per il concatenamento.

`setGradientMidpointWithValue(color, type, value)`

Imposta i campi del punto centrale del gradiente della regola di formattazione condizionale. Cancella tutti i campi del punto centrale se il tipo di interpolazione passato è null.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`String`	Il colore del punto medio da impostare.
`type`	`InterpolationType`	Il tipo di interpolazione del punto medio da impostare o `null` per cancellare.
`value`	`String`	Il valore del punto medio da impostare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setGradientMinpoint(color)`

Cancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola. Consente inoltre di impostare il colore del punto minimo del gradiente sul colore di input.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between white and red, based on their values in comparison to
// the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`String`	Il colore punto minimo da impostare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setGradientMinpointObject(color)`

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere between theme text and background colors, based on their values
// in comparison to the ranges minimum and maximum values.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`Color`	L'oggetto colore del punto minimo da impostare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento per il concatenamento.

`setGradientMinpointObjectWithValue(color, type, value)`

Imposta i campi dei punti minimi del gradiente della regola di formattazione condizionale.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on
// their values in comparison to the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`Color`	Il colore punto minimo da impostare.
`type`	`InterpolationType`	Il tipo di interpolazione del punto minimo da impostare.
`value`	`String`	Il valore minimo da impostare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento per il concatenamento.

`setGradientMinpointWithValue(color, type, value)`

Imposta i campi dei punti minimi del gradiente della regola di formattazione condizionale.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their
// background color somewhere from red to green to blue, based on their values in comparison to
// the values 0, 50, and 100.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`color`	`String`	Il colore punto minimo da impostare.
`type`	`InterpolationType`	Il tipo di interpolazione del punto minimo da impostare.
`value`	`String`	Il valore minimo da impostare.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setItalic(italic)`

Imposta il corsivo del testo per il formato della regola di formattazione condizionale. Se italic è true, la regola applica il corsivo al testo se la condizione è soddisfatta; se false, la regola rimuove eventuale corsivo esistente se la condizione è soddisfatta. Se trasmetti null, l'impostazione del formato corsivo viene rimossa dalla regola.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their
// text italic if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setItalic(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`italic`	`Boolean`	Indica se il testo deve essere in corsivo o meno se la condizione del formato è soddisfatta; `null` rimuove questa impostazione.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setRanges(ranges)`

Imposta uno o più intervalli a cui viene applicata questa regola di formattazione condizionale. Questa operazione sostituisce tutti gli intervalli esistenti. Se imposti un array vuoto, tutti gli intervalli esistenti verranno cancellati. Una regola deve avere almeno un intervallo.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 and range D4:F6
// to turn red if they contain a number between 1 and 10.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeOne = sheet.getRange("A1:B3");
var rangeTwo = sheet.getRange("D4:F6");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([rangeOne, rangeTwo])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`ranges`	`Range[]`	Gli intervalli a cui viene applicata questa regola di formattazione condizionale.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setStrikethrough(strikethrough)`

Imposta il testo barrato per il formato della regola di formattazione condizionale. Se strikethrough è true, la regola barra il testo se la condizione è soddisfatta; con false, la regola rimuove l'eventuale formattazione barrata esistente se la condizione è soddisfatta. Se utilizzi null, l'impostazione del formato barrato viene rimossa dalla regola.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to strikethrough
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setStrikethrough(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`strikethrough`	`Boolean`	Indica se il testo deve essere barrato o meno se la condizione del formato è soddisfatta; `null` rimuove questa impostazione.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setUnderline(underline)`

Imposta il testo di sottolineatura per il formato della regola di formattazione condizionale. Se underline è true, la regola sottolinea il testo se la condizione è soddisfatta; con false, la regola rimuove eventuali sottolineature esistenti se la condizione è soddisfatta. Se trasmetti null, l'impostazione del formato di sottolineatura dalla regola viene rimossa.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to underline
// their text if the cell has text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setUnderline(true)
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`underline`	`Boolean`	Indica se il testo deve essere sottolineato o meno se la condizione del formato è soddisfatta; `null` rimuove questa impostazione.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenCellEmpty()`

Imposta la regola di formattazione condizionale da attivare quando la cella è vuota.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenCellNotEmpty()`

Imposta la regola di formattazione condizionale in modo che venga attivata quando la cella non è vuota.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they are not empty.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellNotEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenDateAfter(date)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è successiva al valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	L'ultima data.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenDateAfter(date)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è successiva alla data relativa specificata.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date after today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`date`	`RelativeDate`	La data più recente relativa al tipo di data selezionato.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenDateBefore(date)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente alla data specificata.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	La prima data non accettabile.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenDateBefore(date)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente alla data relativa specificata.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a date before today.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`date`	`RelativeDate`	La data più recente relativa al tipo di data selezionato.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenDateEqualTo(date)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è uguale alla data specificata.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the date 11/4/1993.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`date`	`Date`	L'unica data accettabile.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenDateEqualTo(date)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è uguale alla data relativa specificata.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain todays date.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`date`	`RelativeDate`	La data più recente relativa al tipo di data selezionato.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenFormulaSatisfied(formula)`

Imposta la regola di formattazione condizionale da attivare quando la formula specificata restituisce true.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they satisfy the condition "=EQ(B4, C3)".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenFormulaSatisfied("=EQ(B4, C3)")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`formula`	`String`	Una formula personalizzata che restituisce `true` se l'input è valido.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberBetween(start, end)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero rientra o rientra tra due valori specificati.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`start`	`Number`	Il valore accettabile più basso.
`end`	`Number`	Il valore accettabile più alto.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberEqualTo(number)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è uguale al valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	L'unico valore accettabile.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberGreaterThan(number)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è maggiore del valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red
// if they contain a number greater than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il valore non accettabile più alto.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberGreaterThanOrEqualTo(number)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è maggiore o uguale al valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number greater than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il valore accettabile più basso.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberLessThan(number)`

Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è inferiore al valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il valore non accettabile più basso.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberLessThanOrEqualTo(number)`

Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è inferiore o uguale al valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number less than or equal to 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	Il valore accettabile più alto.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberNotBetween(start, end)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero non rientra tra i due valori specificati e non corrisponde a nessuno dei due.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain a number not between 1 and 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`start`	`Number`	Il valore non accettabile più basso.
`end`	`Number`	Il valore non accettabile più alto.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberNotEqualTo(number)`

Imposta la regola di formattazione condizionale in modo che si attivi quando un numero non è uguale al valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the number 10.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`number`	`Number`	L'unico valore inaccettabile.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenTextContains(text)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando l'input contiene il valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextContains("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Il valore che deve contenere l'input.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenTextDoesNotContain(text)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando l'input non contiene il valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they don't contain the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextDoesNotContain("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Il valore che l'input non deve contenere.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenTextEndsWith(text)`

Imposta la regola di formattazione condizionale da attivare quando l'input termina con il valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they end with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEndsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Testo da confrontare con la fine della stringa.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenTextEqualTo(text)`

Imposta la regola di formattazione condizionale in modo che si attivi quando l'input è uguale al valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they have text equal to "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	L'unico valore accettabile.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenTextStartsWith(text)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando l'input inizia con il valore specificato.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if
// they start with the text "hello".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextStartsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`text`	`String`	Testo da confrontare con l'inizio della stringa.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`withCriteria(criteria, args)`

Imposta la regola di formattazione condizionale su criteri definiti dai valori BooleanCriteria, recuperati in genere da criteria e arguments di una regola esistente.

// Adds a new conditional format rule that is a copy of the first active
// conditional format rule, except it instead sets its cells to have a black
// background color.

var sheet = SpreadsheetApp.getActiveSheet();
var rules = sheet.getConditionalFormatRules();
var booleanCondition = rules[0].getBooleanCondition();
if (booleanCondition != null) {
  var rule = SpreadsheetApp.newConditionalFormatRule()
      .withCriteria(booleanCondition.getCriteriaType(),
         booleanCondition.getCriteriaValues())
      .setBackground("#000000")
      .setRanges(rule.getRanges())
      .build();
  rules.push(rule);
}
sheet.setConditionalFormatRules(rules);

Parametri

Nome	Tipo	Descrizione
`criteria`	`BooleanCriteria`	Il tipo di criteri di formattazione condizionale.
`args`	`Object[]`	Un array di argomenti appropriato per il tipo di criteri; il numero di argomenti e il relativo tipo corrispondono al metodo `when...()` corrispondente riportato sopra.

Ritorni

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento