Class ConditionalFormatRuleBuilder

Generatore di regole di formattazione condizionale

Generatore 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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Metodi

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

Documentazione dettagliata

build()

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

Indietro

ConditionalFormatRule: una rappresentazione della regola di formattazione condizionale.


copy()

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

Indietro

ConditionalFormatRuleBuilder: un builder basato sulle impostazioni di questa regola.


getBooleanCondition()

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

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

Indietro

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


getGradientCondition()

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

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

Indietro

GradientCondition: l'oggetto condizione sfumatura o null se la regola non utilizza una condizione sfumatura.


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.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

Indietro

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. L'inserimento di null rimuove l'impostazione di formattazione 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".

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

Parametri

NomeTipoDescrizione
colorStringIl colore desiderato o null per cancellare.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setBackgroundObject(color)

Imposta il colore di sfondo per il formato della regola di formattazione condizionale. L'inserimento di null rimuove l'impostazione di formattazione 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".

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

Parametri

NomeTipoDescrizione
colorColorL'oggetto colore desiderato o null per cancellare.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setBold(bold)

Imposta il grassetto 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 qualsiasi grassetto esistente se la condizione è soddisfatta. L'inserimento di null rimuove l'impostazione del formato in grassetto 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".

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

Parametri

NomeTipoDescrizione
boldBooleanIndica se il testo deve essere visualizzato in grassetto se la condizione di formattazione è soddisfatta; null rimuove questa impostazione.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setFontColor(color)

Imposta il colore del carattere per il formato della regola di formattazione condizionale. L'inserimento di null rimuove l'impostazione del formato del colore del carattere 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".

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

Parametri

NomeTipoDescrizione
colorStringIl colore desiderato o null per cancellare.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setFontColorObject(color)

Imposta il colore del carattere per il formato della regola di formattazione condizionale. L'inserimento di null rimuove l'impostazione del formato del colore del carattere 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".

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

Parametri

NomeTipoDescrizione
colorColorL'oggetto colore desiderato o null per cancellare.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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 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.

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

Parametri

NomeTipoDescrizione
colorStringIl colore del punto massimo da impostare.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setGradientMaxpointObject(color)

Cancella il valore 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 theme text and background
// colors, based on their values in comparison to the ranges minimum and maximum
// values.

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

Parametri

NomeTipoDescrizione
colorColorL'oggetto colore punto massimo da impostare.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setGradientMaxpointObjectWithValue(color, type, value)

Imposta i campi maxpoint 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.

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

Parametri

NomeTipoDescrizione
colorColorIl colore del punto massimo da impostare.
typeInterpolationTypeIl tipo di interpolazione maxpoint da impostare.
valueStringIl valore maxpoint da impostare.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setGradientMaxpointWithValue(color, type, value)

Imposta i campi maxpoint 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.

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

Parametri

NomeTipoDescrizione
colorStringIl colore del punto massimo da impostare.
typeInterpolationTypeIl tipo di interpolazione maxpoint da impostare.
valueStringIl valore maxpoint da impostare.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setGradientMidpointObjectWithValue(color, type, value)

Imposta i campi del punto medio del gradiente della regola di formattazione condizionale. Cancella tutti i campi del punto medio 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.

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

Parametri

NomeTipoDescrizione
colorColorIl colore intermedio da impostare.
typeInterpolationTypeIl tipo di interpolazione del punto medio da impostare o null da cancellare.
valueStringIl valore del punto medio da impostare.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setGradientMidpointWithValue(color, type, value)

Imposta i campi del punto medio del gradiente della regola di formattazione condizionale. Cancella tutti i campi del punto medio 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.

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

Parametri

NomeTipoDescrizione
colorStringIl colore intermedio da impostare.
typeInterpolationTypeIl tipo di interpolazione del punto medio da impostare o null da cancellare.
valueStringIl valore del punto medio da impostare.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
colorStringIl colore del punto minimo da impostare.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setGradientMinpointObject(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 theme text and background
// colors, based on their values in comparison to the ranges minimum and maximum
// values.

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

Parametri

NomeTipoDescrizione
colorColorL'oggetto colore punto minimo da impostare.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
colorColorIl colore del punto minimo da impostare.
typeInterpolationTypeIl tipo di interpolazione minpoint da impostare.
valueStringIl valore del punto minimo da impostare.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
colorStringIl colore del punto minimo da impostare.
typeInterpolationTypeIl tipo di interpolazione minpoint da impostare.
valueStringIl valore del punto minimo da impostare.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setItalic(italic)

Imposta il corsivo 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 corsivo esistente se la condizione è soddisfatta. Se inserisci 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".

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

Parametri

NomeTipoDescrizione
italicBooleanIndica se il testo deve essere in corsivo se la condizione di formattazione è soddisfatta; null rimuove questa impostazione.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setRanges(ranges)

Imposta uno o più intervalli a cui viene applicata questa regola di formattazione condizionale. Questa operazione sostituisce eventuali intervalli esistenti. Se imposti un array vuoto, vengono cancellati tutti gli intervalli esistenti. 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.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeOne = sheet.getRange('A1:B3');
const rangeTwo = sheet.getRange('D4:F6');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([rangeOne, rangeTwo])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Parametri

NomeTipoDescrizione
rangesRange[]Gli intervalli a cui viene applicata questa regola di formattazione condizionale.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setStrikethrough(strikethrough)

Imposta la barratura del testo per il formato della regola di formattazione condizionale. Se strikethrough è true, la regola sbarra il testo se la condizione è soddisfatta; se false, la regola rimuove qualsiasi formattazione di sbarratura esistente se la condizione è soddisfatta. L'inserimento di null rimuove l'impostazione di formattazione barrata 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".

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

Parametri

NomeTipoDescrizione
strikethroughBooleanIndica se il testo deve essere barrato se la condizione di formattazione è soddisfatta; null rimuove questa impostazione.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


setUnderline(underline)

Imposta la sottolineatura del testo 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 le sottolineature esistenti se la condizione è soddisfatta. L'inserimento di null rimuove l'impostazione di formattazione della sottolineatura 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".

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

Parametri

NomeTipoDescrizione
underlineBooleanSe il testo deve essere sottolineato o meno se la condizione di formattazione è soddisfatta; null rimuove questa impostazione.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


whenCellEmpty()

Imposta la regola di formattazione condizionale in modo che venga attivata 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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenCellEmpty()
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenCellNotEmpty()
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


whenDateAfter(date)

Imposta l'attivazione della regola di formattazione condizionale 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.

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

Parametri

NomeTipoDescrizione
dateDateLa data più recente.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
dateRelativeDateLa data più recente rispetto al tipo di data selezionato.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
dateDateLa prima data non accettabile.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
dateRelativeDateLa data più recente rispetto al tipo di data selezionato.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
dateDateL'unica data accettabile.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
dateRelativeDateLa data più recente rispetto al tipo di data selezionato.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


whenFormulaSatisfied(formula)

Imposta la regola di formattazione condizionale in modo che venga attivata quando la formula specificata restituisce il valore 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)".

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

Parametri

NomeTipoDescrizione
formulaStringUna formula personalizzata che restituisce true se l'input è valido.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


whenNumberBetween(start, end)

Imposta la regola di formattazione condizionale in modo che si attivi quando un numero rientra tra due valori specificati o è uguale a uno di questi.

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

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

Parametri

NomeTipoDescrizione
startNumberIl valore minimo accettabile.
endNumberIl valore accettabile più alto.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
numberNumberL'unico valore accettabile.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
numberNumberIl valore inaccettabile più alto.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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.

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

Parametri

NomeTipoDescrizione
numberNumberIl valore minimo accettabile.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


whenNumberLessThan(number)

Imposta la regola di formattazione condizionale in modo che venga attivata 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.

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

Parametri

NomeTipoDescrizione
numberNumberIl valore più basso inaccettabile.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


whenNumberLessThanOrEqualTo(number)

Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è minore 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.

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

Parametri

NomeTipoDescrizione
numberNumberIl valore accettabile più alto.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


whenNumberNotBetween(start, end)

Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero non rientra tra due valori specificati e non è uguale 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.

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

Parametri

NomeTipoDescrizione
startNumberIl valore più basso inaccettabile.
endNumberIl valore inaccettabile più alto.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


whenNumberNotEqualTo(number)

Imposta la regola di formattazione condizionale in modo che venga attivata 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.

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

Parametri

NomeTipoDescrizione
numberNumberL'unico valore non accettabile.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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".

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

Parametri

NomeTipoDescrizione
textStringIl valore che deve contenere l'input.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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".

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

Parametri

NomeTipoDescrizione
textStringIl valore che l'input non deve contenere.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


whenTextEndsWith(text)

Imposta la regola di formattazione condizionale in modo che venga attivata 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".

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

Parametri

NomeTipoDescrizione
textStringTesto da confrontare con la fine della stringa.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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".

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

Parametri

NomeTipoDescrizione
textStringL'unico valore accettabile.

Indietro

ConditionalFormatRuleBuilder: il generatore, 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".

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

Parametri

NomeTipoDescrizione
textStringTesto da confrontare con l'inizio della stringa.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.


withCriteria(criteria, args)

Imposta la regola di formattazione condizionale sui criteri definiti dai valori BooleanCriteria, in genere presi 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.

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

Parametri

NomeTipoDescrizione
criteriaBooleanCriteriaIl tipo di criteri di formattazione condizionale.
argsObject[]Un array di argomenti appropriati per il tipo di criteri; il numero di argomenti e il loro tipo corrispondono al metodo when...() corrispondente riportato sopra.

Indietro

ConditionalFormatRuleBuilder: il generatore, per il concatenamento.