Questa pagina è stata tradotta dall'API Cloud Translation.

Class ConditionalFormatRuleBuilder

Builder per le 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`	Consente di creare una regola di formattazione condizionale in base alle impostazioni applicate allo strumento di creazione.
`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 i criteri di condizione booleani.
`getGradientCondition()`	`GradientCondition`	Recupera le informazioni `GradientCondition` della regola, se questa regola utilizza criteri delle condizioni 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 per il 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 del punto massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola.
`setGradientMaxpointObject(color)`	`ConditionalFormatRuleBuilder`	Cancella il valore del punto 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 minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola.
`setGradientMinpointObject(color)`	`ConditionalFormatRuleBuilder`	Cancella il valore 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 del punto minimo del gradiente della regola di formattazione condizionale.
`setGradientMinpointWithValue(color, type, value)`	`ConditionalFormatRuleBuilder`	Imposta i campi del punto minimo del gradiente della regola di formattazione condizionale.
`setItalic(italic)`	`ConditionalFormatRuleBuilder`	Imposta il corsivo per il testo per il formato della regola di formattazione condizionale.
`setRanges(ranges)`	`ConditionalFormatRuleBuilder`	Consente di impostare 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 sottolineato 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 da attivare 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 a quella 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 da attivare quando una data corrisponde a quella specificata.
`whenDateEqualTo(date)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando una data corrisponde 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 da attivare quando un numero rientra tra due o è uno di due i valori specificati.
`whenNumberEqualTo(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando un numero è uguale al valore specificato.
`whenNumberGreaterThan(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando un numero è maggiore del valore specificato.
`whenNumberGreaterThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando un numero è maggiore o uguale al valore specificato valore.
`whenNumberLessThan(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è inferiore a quello specificato valore.
`whenNumberLessThanOrEqualTo(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando un numero è minore o uguale al valore specificato valore.
`whenNumberNotBetween(start, end)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando un numero non rientra tra quelli e non è nessuno dei due valori due valori specificati.
`whenNumberNotEqualTo(number)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando un numero è diverso dal valore specificato.
`whenTextContains(text)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando l'input contiene il valore specificato.
`whenTextDoesNotContain(text)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando l'input non contiene il valore.
`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 da attivare quando l'input è uguale al valore specificato.
`whenTextStartsWith(text)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale da attivare quando l'input inizia con il valore specificato.
`withCriteria(criteria, args)`	`ConditionalFormatRuleBuilder`	Imposta la regola di formattazione condizionale sui criteri definiti dai valori `BooleanCriteria`, tipicamente ricavato da `criteria` e `arguments` di un una regola esistente.

Documentazione dettagliata

`build()`

Consente di creare una regola di formattazione condizionale in base alle impostazioni applicate allo strumento di creazione.

Invio

ConditionalFormatRule: una rappresentazione della regola di formattazione condizionale

`copy()`

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

Invio

ConditionalFormatRuleBuilder: uno strumento per la creazione basato sulle impostazioni di questa regola

`getBooleanCondition()`

Recupera le informazioni BooleanCondition della regola se questa regola utilizza i 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());
}

Invio

BooleanCondition: l'oggetto condizione booleano o null se la regola non utilizza un valore booleano .

`getGradientCondition()`

Recupera le informazioni GradientCondition della regola, se questa regola utilizza criteri delle condizioni 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());
}

Invio

GradientCondition: l'oggetto condizione gradiente o null se la regola non utilizza un 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());
}

Invio

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

`setBackground(color)`

Imposta il colore di sfondo per il formato della regola di formattazione condizionale. Superamento tra null l'impostazione del formato del colore di sfondo viene rimossa 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 o `null` da cancellare.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setBackgroundObject(color)`

Imposta il colore di sfondo per il formato della regola di formattazione condizionale. Superamento tra null l'impostazione del formato del colore di sfondo viene rimossa 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 del colore o `null` da cancellare.

Invio

ConditionalFormatRuleBuilder - Lo strumento di creazione, per il concatenamento.

`setBold(bold)`

Imposta il grassetto per il testo per il formato della regola di formattazione condizionale. Se bold è true, la regola mette in grassetto il testo se la condizione è soddisfatta; se false, la regola rimuove tutti gli eventuali in grassetto se la condizione è soddisfatta. L'approvazione in null rimuove l'impostazione del formato in grassetto da la 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 se la condizione del formato è soddisfatta. `null` rimuove questa impostazione.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setFontColor(color)`

Imposta il colore del carattere per il formato della regola di formattazione condizionale. Il superamento della soglia tra null comporta la rimozione l'impostazione del formato di colore del carattere nella 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 o `null` da cancellare.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setFontColorObject(color)`

// 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 del colore o `null` da cancellare.

Invio

ConditionalFormatRuleBuilder - Lo strumento di creazione, per il concatenamento.

`setGradientMaxpoint(color)`

Cancella il valore del punto massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola. Imposta anche il colore del 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 del punto massimo da impostare.

Invio

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 del punto massimo da impostare.

Invio

ConditionalFormatRuleBuilder - Lo strumento di creazione, 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 del punto massimo da impostare.
`type`	`InterpolationType`	Il tipo di interpolazione del punto massimo da impostare.
`value`	`String`	Il valore del punto massimo da impostare.

Invio

ConditionalFormatRuleBuilder - Lo strumento di creazione, 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 del punto massimo da impostare.
`type`	`InterpolationType`	Il tipo di interpolazione del punto massimo da impostare.
`value`	`String`	Il valore del punto massimo da impostare.

Invio

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 centrale da impostare o `null` da cancellare.
`value`	`String`	Il valore del punto medio da impostare.

Invio

ConditionalFormatRuleBuilder - Lo strumento di creazione, 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 centrale da impostare o `null` da cancellare.
`value`	`String`	Il valore del punto medio da impostare.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setGradientMinpoint(color)`

Cancella il valore minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola. Imposta anche 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 del punto minimo da impostare.

Invio

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.

Invio

ConditionalFormatRuleBuilder - Lo strumento di creazione, per il concatenamento.

`setGradientMinpointObjectWithValue(color, type, value)`

Imposta i campi del punto minimo 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 del punto minimo da impostare.
`type`	`InterpolationType`	Il tipo di interpolazione del punto minimo da impostare.
`value`	`String`	Il valore del punto minimo da impostare.

Invio

ConditionalFormatRuleBuilder - Lo strumento di creazione, per il concatenamento.

`setGradientMinpointWithValue(color, type, value)`

Imposta i campi del punto minimo 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 del punto minimo da impostare.
`type`	`InterpolationType`	Il tipo di interpolazione del punto minimo da impostare.
`value`	`String`	Il valore del punto minimo da impostare.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setItalic(italic)`

Imposta il corsivo per il testo per il formato della regola di formattazione condizionale. Se italic è true, la regola mette in corsivo il testo se la condizione è soddisfatta; se false, la regola rimuove qualsiasi se la condizione è soddisfatta. Il corsivo viene rimosso tra null dell'impostazione del formato 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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setRanges(ranges)`

Consente di impostare uno o più intervalli a cui viene applicata questa regola di formattazione condizionale. Questa operazione sostituisce qualsiasi intervallo esistente. L'impostazione di un array vuoto cancella tutti gli intervalli esistenti. Una regola deve abbia 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.

Invio

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; se false, la regola rimuove l'eventuale formattazione barrata esistente se la condizione è soddisfatta. Superamento tra 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 è met; `null` rimuove questa impostazione.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`setUnderline(underline)`

Imposta il testo sottolineato per il formato della regola di formattazione condizionale. Se underline è true, la regola sottolinea il testo se la condizione è soddisfatta. se false, la regola rimuove qualsiasi sottolineature esistenti se la condizione è soddisfatta. Il passaggio tra null rimuove la sottolineatura dell'impostazione del formato dalla regola.

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

Invio

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

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenCellNotEmpty()`

Imposta la regola di formattazione condizionale da attivare 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);

Invio

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`	La data più recente.

Invio

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`	L'ultima data in relazione al tipo di data selezionato.

Invio

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 a quella 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.

Invio

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`	L'ultima data in relazione al tipo di data selezionato.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenDateEqualTo(date)`

Imposta la regola di formattazione condizionale da attivare quando una data corrisponde a quella 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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenDateEqualTo(date)`

Imposta la regola di formattazione condizionale da attivare quando una data corrisponde 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`	L'ultima data in relazione al tipo di data selezionato.

Invio

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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberBetween(start, end)`

Imposta la regola di formattazione condizionale da attivare quando un numero rientra tra due o è uno di due i 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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberEqualTo(number)`

Imposta la regola di formattazione condizionale da attivare 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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberGreaterThan(number)`

Imposta la regola di formattazione condizionale da attivare 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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberGreaterThanOrEqualTo(number)`

Imposta la regola di formattazione condizionale da attivare quando un numero è maggiore o uguale al valore specificato valore.

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

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberLessThan(number)`

Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è inferiore a quello specificato valore.

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

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberLessThanOrEqualTo(number)`

Imposta la regola di formattazione condizionale da attivare quando un numero è minore o uguale al valore specificato valore.

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

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberNotBetween(start, end)`

Imposta la regola di formattazione condizionale da attivare quando un numero non rientra tra quelli e non è nessuno dei due valori 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 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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenNumberNotEqualTo(number)`

Imposta la regola di formattazione condizionale da attivare quando un numero è diverso dal 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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenTextContains(text)`

Imposta la regola di formattazione condizionale da attivare 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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenTextDoesNotContain(text)`

Imposta la regola di formattazione condizionale da attivare quando l'input non contiene il valore.

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

Invio

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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenTextEqualTo(text)`

Imposta la regola di formattazione condizionale da attivare 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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`whenTextStartsWith(text)`

Imposta la regola di formattazione condizionale da attivare 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.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento

`withCriteria(criteria, args)`

Imposta la regola di formattazione condizionale sui criteri definiti dai valori BooleanCriteria, tipicamente ricavato da criteria e arguments di un 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 del formato condizionale.
`args`	`Object[]`	Un array di argomenti appropriati al tipo di criteri; il numero di argomenti e il loro tipo corrisponde al metodo `when...()` corrispondente sopra indicato.

Invio

ConditionalFormatRuleBuilder: lo strumento di creazione, per il concatenamento