Class ConditionalFormatRuleBuilder

Generatorediregolediformattazionecondizionale

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()ConditionalFormatRuleCostruisce 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 utilizza i criteri della 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 testo in 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 del punto di massima sfumatura della regola di formattazione condizionale e utilizza il valore massimo nei relativi intervalli.
setGradientMaxpointObject(color)ConditionalFormatRuleBuilderCancella il valore del punto di massima sfumatura della regola di formattazione condizionale e utilizza il valore massimo nei relativi intervalli.
setGradientMaxpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderImposta i campi punto massimo del gradiente della regola di formattazione condizionale.
setGradientMaxpointWithValue(color, type, value)ConditionalFormatRuleBuilderImposta i campi punto massimo del gradiente della regola di formattazione condizionale.
setGradientMidpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderImposta i campi del punto intermedio del gradiente della regola di formattazione condizionale.
setGradientMidpointWithValue(color, type, value)ConditionalFormatRuleBuilderImposta i campi del punto intermedio del gradiente della regola di formattazione condizionale.
setGradientMinpoint(color)ConditionalFormatRuleBuilderCancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza il valore minimo gli intervalli della regola.
setGradientMinpointObject(color)ConditionalFormatRuleBuilderCancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza il valore minimo gli intervalli della regola.
setGradientMinpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderImposta i campi punto minimo del gradiente della regola di formattazione condizionale.
setGradientMinpointWithValue(color, type, value)ConditionalFormatRuleBuilderImposta i campi punto minimo del gradiente della regola di formattazione condizionale.
setItalic(italic)ConditionalFormatRuleBuilderImposta il testo in 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 il barrato 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 da attivare quando la cella è vuota.
whenCellNotEmpty()ConditionalFormatRuleBuilderImposta la regola di formattazione condizionale in modo che venga attivata quando la cella non è vuota.
whenDateAfter(date)ConditionalFormatRuleBuilderImposta la regola di formattazione condizionale in modo che si attivi 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 a quella 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 da attivare quando la formula specificata ha valore true.
whenNumberBetween(start, end)ConditionalFormatRuleBuilderImposta la regola di formattazione condizionale in modo che si attivi quando un numero è compreso tra due valori specificati o è uno di questi.
whenNumberEqualTo(number)ConditionalFormatRuleBuilderImposta la regola di formattazione condizionale in modo che si attivi quando un numero è uguale al valore specificato.
whenNumberGreaterThan(number)ConditionalFormatRuleBuilderImposta la regola di formattazione condizionale in modo che si attivi quando un numero è maggiore del valore specificato.
whenNumberGreaterThanOrEqualTo(number)ConditionalFormatRuleBuilderImposta la regola di formato 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 si attivi quando un numero è inferiore al valore fornito.
whenNumberLessThanOrEqualTo(number)ConditionalFormatRuleBuilderImposta la regola di formattazione condizionale in modo che venga attivata quando un numero è minore o uguale al valore fornito.
whenNumberNotBetween(start, end)ConditionalFormatRuleBuilderImposta la regola di formato condizionale in modo che si attivi 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 si attivi quando un numero non è uguale al valore specificato.
whenTextContains(text)ConditionalFormatRuleBuilderImposta la regola di formattazione condizionale in modo che si attivi 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 si attivi 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 si attivi quando l'input inizia con il valore specificato.
withCriteria(criteria, args)ConditionalFormatRuleBuilderImposta la regola del formato condizionale in base ai criteri definiti dai valori BooleanCriteria, tipicamente ricavati da criteria e arguments di una regola esistente.

Documentazione dettagliata

build()

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

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: un generatore 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());
}

Invio

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


getGradientCondition()

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

Invio

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

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. Se specifichi null viene rimossa l'impostazione di formato del colore di sfondo dalla regola.

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

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.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


setBackgroundObject(color)

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

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

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 di colore desiderato o null per cancellare.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento.


setBold(bold)

Imposta il testo in 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 eventuali caratteri in grassetto esistenti se la condizione è soddisfatta. Se passi null, l'impostazione di formattazione in grassetto viene rimossa dalla regola.

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

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 in grassetto se la condizione di formattazione è soddisfatta. null rimuove questa impostazione.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


setFontColor(color)

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

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


setFontColorObject(color)

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

// 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 di colore desiderato o null per cancellare.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento.


setGradientMaxpoint(color)

Cancella il valore del punto di massima sfumatura della regola di formattazione condizionale e utilizza il valore massimo nei relativi intervalli. 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.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


setGradientMaxpointObject(color)

Cancella il valore del punto di massima sfumatura della regola di formattazione condizionale e utilizza il valore massimo nei relativi intervalli. 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.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento.


setGradientMaxpointObjectWithValue(color, type, value)

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

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento.


setGradientMaxpointWithValue(color, type, value)

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

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


setGradientMidpointObjectWithValue(color, type, value)

Imposta i campi del punto intermedio del gradiente della regola di formattazione condizionale. Cancella tutti i campi relativi al punto intermedio 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 del punto intermedio da impostare.
typeInterpolationTypeIl tipo di interpolazione del punto intermedio da impostare o null per cancellare.
valueStringIl valore del punto medio da impostare.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento.


setGradientMidpointWithValue(color, type, value)

Imposta i campi del punto intermedio del gradiente della regola di formattazione condizionale. Cancella tutti i campi relativi al punto intermedio 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 del punto intermedio da impostare.
typeInterpolationTypeIl tipo di interpolazione del punto intermedio da impostare o null per cancellare.
valueStringIl valore del punto medio da impostare.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


setGradientMinpoint(color)

Cancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza il valore minimo gli intervalli della regola. Imposta anche il colore del punto minimo del gradiente sul colore inserito.

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


setGradientMinpointObject(color)

Cancella il valore del punto minimo del gradiente della regola di formattazione condizionale e utilizza il valore minimo gli intervalli della regola. Imposta anche il colore del punto minimo del gradiente sul colore inserito.

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento.


setGradientMinpointObjectWithValue(color, type, value)

Imposta i campi 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 del punto minimo da impostare.
valueStringIl valore punto minimo da impostare.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento.


setGradientMinpointWithValue(color, type, value)

Imposta i campi 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 del punto minimo da impostare.
valueStringIl valore punto minimo da impostare.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


setItalic(italic)

Imposta il testo in 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 eventuali testi in corsivo se la condizione è soddisfatta. Se specifichi null, l'impostazione di formattazione in 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 formato è soddisfatta. null rimuove questa impostazione.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


setRanges(ranges)

Imposta uno o più intervalli a cui viene applicata questa regola di formattazione condizionale. Questa operazione sostituisce eventuali intervalli esistenti. L'impostazione di un array vuoto cancella 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.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


setStrikethrough(strikethrough)

Imposta il barrato del testo 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 la formattazione barrata esistente se la condizione è soddisfatta. Se specifichi null, la regola rimuove l'impostazione di formattazione barrata.

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


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 eventuali sottolineature esistenti se la condizione è soddisfatta. Se specifichi null, l'impostazione di formato del testo sottolineato viene rimossa 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
underlineBooleanIndica se il testo deve essere sottolineato se la condizione di formattazione è soddisfatta. null rimuove questa impostazione.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenDateAfter(date)

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


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 relativa al tipo di data selezionato.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


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 data meno recente non accettabile.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


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 relativa al tipo di data selezionato.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenDateEqualTo(date)

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

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.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


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 relativa al tipo di data selezionato.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenFormulaSatisfied(formula)

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenNumberBetween(start, end)

Imposta la regola di formattazione condizionale in modo che si attivi quando un numero è compreso tra due valori specificati o è 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.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenNumberEqualTo(number)

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenNumberGreaterThan(number)

Imposta la regola di formattazione condizionale in modo che si attivi 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 non accettabile più alto.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenNumberGreaterThanOrEqualTo(number)

Imposta la regola di formato 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.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenNumberLessThan(number)

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

// 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 minimo non accettabile.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenNumberLessThanOrEqualTo(number)

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

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenNumberNotBetween(start, end)

Imposta la regola di formato condizionale in modo che si attivi 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 minimo non accettabile.
endNumberIl valore non accettabile più alto.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenNumberNotEqualTo(number)

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

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

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenTextContains(text)

Imposta la regola di formattazione condizionale in modo che si attivi 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 l'input deve contenere.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


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.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenTextEndsWith(text)

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

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


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.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


whenTextStartsWith(text)

Imposta la regola di formattazione condizionale in modo che si attivi 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
textStringIl testo da confrontare con l'inizio della stringa.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento


withCriteria(criteria, args)

Imposta la regola del formato condizionale in base ai criteri definiti dai valori BooleanCriteria, tipicamente ricavati 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 al tipo di criteri; il numero di argomenti e il loro tipo corrispondono al metodo when...() corrispondente riportato sopra.

Invio

ConditionalFormatRuleBuilder: il generatore, per l'accodamento