Builder per le regole di formattazione condizionale.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
build() | ConditionalFormatRule | Consente di creare una regola di formattazione condizionale in base alle impostazioni applicate allo strumento di creazione. |
copy() | ConditionalFormatRuleBuilder | Restituisce un preset del generatore di regole con le impostazioni di questa regola. |
getBooleanCondition() | BooleanCondition | Recupera le informazioni BooleanCondition della regola se questa regola utilizza
i criteri di condizione booleani. |
getGradientCondition() | GradientCondition | Recupera le informazioni GradientCondition della regola, se questa regola
utilizza criteri delle condizioni del gradiente. |
getRanges() | Range[] | Recupera gli intervalli a cui viene applicata questa regola di formattazione condizionale. |
setBackground(color) | ConditionalFormatRuleBuilder | Imposta il colore di sfondo per il formato della regola di formattazione condizionale. |
setBackgroundObject(color) | ConditionalFormatRuleBuilder | Imposta il colore di sfondo per il formato della regola di formattazione condizionale. |
setBold(bold) | ConditionalFormatRuleBuilder | Imposta il grassetto per il testo per il formato della regola di formattazione condizionale. |
setFontColor(color) | ConditionalFormatRuleBuilder | Imposta il colore del carattere per il formato della regola di formattazione condizionale. |
setFontColorObject(color) | ConditionalFormatRuleBuilder | Imposta il colore del carattere per il formato della regola di formattazione condizionale. |
setGradientMaxpoint(color) | ConditionalFormatRuleBuilder | Cancella il valore del punto massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola. |
setGradientMaxpointObject(color) | ConditionalFormatRuleBuilder | Cancella il valore del punto massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola. |
setGradientMaxpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Imposta i campi del punto massimo del gradiente della regola di formattazione condizionale. |
setGradientMaxpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Imposta i campi del punto massimo del gradiente della regola di formattazione condizionale. |
setGradientMidpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Imposta i campi del punto centrale del gradiente della regola di formattazione condizionale. |
setGradientMidpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Imposta i campi del punto centrale del gradiente della regola di formattazione condizionale. |
setGradientMinpoint(color) | ConditionalFormatRuleBuilder | Cancella il valore minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola. |
setGradientMinpointObject(color) | ConditionalFormatRuleBuilder | Cancella il valore minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola. |
setGradientMinpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Imposta i campi del punto minimo del gradiente della regola di formattazione condizionale. |
setGradientMinpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Imposta i campi del punto minimo del gradiente della regola di formattazione condizionale. |
setItalic(italic) | ConditionalFormatRuleBuilder | Imposta il corsivo per il testo per il formato della regola di formattazione condizionale. |
setRanges(ranges) | ConditionalFormatRuleBuilder | Consente di impostare uno o più intervalli a cui viene applicata questa regola di formattazione condizionale. |
setStrikethrough(strikethrough) | ConditionalFormatRuleBuilder | Imposta il testo barrato per il formato della regola di formattazione condizionale. |
setUnderline(underline) | ConditionalFormatRuleBuilder | Imposta il testo sottolineato per il formato della regola di formattazione condizionale. |
whenCellEmpty() | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando la cella è vuota. |
whenCellNotEmpty() | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando la cella non è vuota. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è successiva al valore specificato. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è successiva alla data relativa specificata. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente a quella specificata. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente alla data relativa specificata. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando una data corrisponde a quella specificata. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando una data corrisponde alla data relativa specificata. |
whenFormulaSatisfied(formula) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando la formula specificata restituisce true . |
whenNumberBetween(start, end) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando un numero rientra tra due o è uno di due i valori specificati. |
whenNumberEqualTo(number) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando un numero è uguale al valore specificato. |
whenNumberGreaterThan(number) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando un numero è maggiore del valore specificato. |
whenNumberGreaterThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando un numero è maggiore o uguale al valore specificato valore. |
whenNumberLessThan(number) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è inferiore a quello specificato valore. |
whenNumberLessThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando un numero è minore o uguale al valore specificato valore. |
whenNumberNotBetween(start, end) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando un numero non rientra tra quelli e non è nessuno dei due valori due valori specificati. |
whenNumberNotEqualTo(number) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando un numero è diverso dal valore specificato. |
whenTextContains(text) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando l'input contiene il valore specificato. |
whenTextDoesNotContain(text) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando l'input non contiene il valore. |
whenTextEndsWith(text) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando l'input termina con il valore specificato. |
whenTextEqualTo(text) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando l'input è uguale al valore specificato. |
whenTextStartsWith(text) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale da attivare quando l'input inizia con il valore specificato. |
withCriteria(criteria, args) | ConditionalFormatRuleBuilder | Imposta la regola di formattazione condizionale sui criteri definiti dai valori BooleanCriteria ,
tipicamente ricavato da criteria e arguments di un
una regola esistente. |
Documentazione dettagliata
build()
Consente di creare una regola di formattazione condizionale in base alle impostazioni applicate allo strumento di creazione.
Invio
ConditionalFormatRule
: una rappresentazione della regola di formattazione condizionale
copy()
Restituisce un preset del generatore di regole con le impostazioni di questa regola.
Invio
ConditionalFormatRuleBuilder
: uno strumento per la creazione basato sulle impostazioni di questa regola
getBooleanCondition()
Recupera le informazioni BooleanCondition
della regola se questa regola utilizza
i criteri di condizione booleani. In caso contrario, restituisce null
.
// Log the boolean criteria type of the first conditional format rules of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var booleanCondition = rule.getBooleanCondition(); if (booleanCondition != null) { Logger.log(booleanCondition.getCriteriaType()); }
Invio
BooleanCondition
: l'oggetto condizione booleano o null
se la regola non utilizza un valore booleano
.
getGradientCondition()
Recupera le informazioni GradientCondition
della regola, se questa regola
utilizza criteri delle condizioni del gradiente. In caso contrario, restituisce null
.
// Log the gradient minimum color of the first conditional format rule of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var gradientCondition = rule.getGradientCondition(); if (gradientCondition != null) { // Assume the color has ColorType.RGB. Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString()); }
Invio
GradientCondition
: l'oggetto condizione gradiente o null
se la regola non utilizza un gradiente.
.
getRanges()
Recupera gli intervalli a cui viene applicata questa regola di formattazione condizionale.
// Log each range of the first conditional format rule of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var ranges = rule.getRanges(); for (var i = 0; i < ranges.length; i++) { Logger.log(ranges[i].getA1Notation()); }
Invio
Range[]
: gli intervalli a cui viene applicata questa regola di formattazione condizionale.
setBackground(color)
Imposta il colore di sfondo per il formato della regola di formattazione condizionale. Superamento tra null
l'impostazione del formato del colore di sfondo viene rimossa dalla regola.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color to red if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore o null da cancellare. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setBackgroundObject(color)
Imposta il colore di sfondo per il formato della regola di formattazione condizionale. Superamento tra null
l'impostazione del formato del colore di sfondo viene rimossa dalla regola.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color to theme background color if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBackground(color) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | L'oggetto del colore o null da cancellare. |
Invio
ConditionalFormatRuleBuilder
- Lo strumento di creazione, per il concatenamento.
setBold(bold)
Imposta il grassetto per il testo per il formato della regola di formattazione condizionale. Se bold
è true
,
la regola mette in grassetto il testo se la condizione è soddisfatta; se false
, la regola rimuove tutti gli eventuali
in grassetto se la condizione è soddisfatta. L'approvazione in null
rimuove l'impostazione del formato in grassetto da
la regola.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their // text bold if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBold(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
bold | Boolean | Indica se il testo deve essere in grassetto se la condizione del formato è soddisfatta. null rimuove questa impostazione. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setFontColor(color)
Imposta il colore del carattere per il formato della regola di formattazione condizionale. Il superamento della soglia tra null
comporta la rimozione
l'impostazione del formato di colore del carattere
nella regola.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font // color to red if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setFontColor("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore o null da cancellare. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setFontColorObject(color)
Imposta il colore del carattere per il formato della regola di formattazione condizionale. Il superamento della soglia tra null
comporta la rimozione
l'impostazione del formato di colore del carattere
nella regola.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font // color to theme text color if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setFontColor(color) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | L'oggetto del colore o null da cancellare. |
Invio
ConditionalFormatRuleBuilder
- Lo strumento di creazione, per il concatenamento.
setGradientMaxpoint(color)
Cancella il valore del punto massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola. Imposta anche il colore del punto massimo del gradiente sul colore di input.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between white and red, based on their values in comparison to // the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint("#FF0000") .setGradientMinpoint("#FFFFFF") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del punto massimo da impostare. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setGradientMaxpointObject(color)
Cancella il valore del punto massimo del gradiente della regola di formattazione condizionale e utilizza invece il valore massimo negli intervalli della regola. Imposta anche il colore del punto massimo del gradiente sul colore di input.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between theme text and background colors, based on their values // in comparison to the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var textColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var backgroundColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint(textColor) .setGradientMinpoint(backgroundColor) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | L'oggetto colore del punto massimo da impostare. |
Invio
ConditionalFormatRuleBuilder
- Lo strumento di creazione, per il concatenamento.
setGradientMaxpointObjectWithValue(color, type, value)
Imposta i campi del punto massimo del gradiente della regola di formattazione condizionale.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from theme accent 1, accent 2 to accent 3 colors, based on their // values in comparison to the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | Il colore del punto massimo da impostare. |
type | InterpolationType | Il tipo di interpolazione del punto massimo da impostare. |
value | String | Il valore del punto massimo da impostare. |
Invio
ConditionalFormatRuleBuilder
- Lo strumento di creazione, per il concatenamento.
setGradientMaxpointWithValue(color, type, value)
Imposta i campi del punto massimo del gradiente della regola di formattazione condizionale.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from red green to blue, based on their values in comparison to // the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del punto massimo da impostare. |
type | InterpolationType | Il tipo di interpolazione del punto massimo da impostare. |
value | String | Il valore del punto massimo da impostare. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setGradientMidpointObjectWithValue(color, type, value)
Imposta i campi del punto centrale del gradiente della regola di formattazione condizionale. Cancella tutti i campi del punto centrale
se il tipo di interpolazione passato è null
.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on // their values in comparison to the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | Il colore del punto medio da impostare. |
type | InterpolationType | Il tipo di interpolazione del punto centrale da impostare o null da cancellare. |
value | String | Il valore del punto medio da impostare. |
Invio
ConditionalFormatRuleBuilder
- Lo strumento di creazione, per il concatenamento.
setGradientMidpointWithValue(color, type, value)
Imposta i campi del punto centrale del gradiente della regola di formattazione condizionale. Cancella tutti i campi del punto centrale
se il tipo di interpolazione passato è null
.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from red green to blue, based on their values in comparison to // the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del punto medio da impostare. |
type | InterpolationType | Il tipo di interpolazione del punto centrale da impostare o null da cancellare. |
value | String | Il valore del punto medio da impostare. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setGradientMinpoint(color)
Cancella il valore minimo del gradiente della regola di formattazione condizionale e utilizza invece il valore minimo negli intervalli della regola. Imposta anche il colore del punto minimo del gradiente sul colore di input.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between white and red, based on their values in comparison to // the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint("#FF0000") .setGradientMinpoint("#FFFFFF") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del punto minimo da impostare. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setGradientMinpointObject(color)
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. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var textColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var backgroundColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint(textColor) .setGradientMinpoint(backgroundColor) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | L'oggetto colore del punto minimo da impostare. |
Invio
ConditionalFormatRuleBuilder
- Lo strumento di creazione, per il concatenamento.
setGradientMinpointObjectWithValue(color, type, value)
Imposta i campi del punto minimo del gradiente della regola di formattazione condizionale.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on // their values in comparison to the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | Color | Il colore del punto minimo da impostare. |
type | InterpolationType | Il tipo di interpolazione del punto minimo da impostare. |
value | String | Il valore del punto minimo da impostare. |
Invio
ConditionalFormatRuleBuilder
- Lo strumento di creazione, per il concatenamento.
setGradientMinpointWithValue(color, type, value)
Imposta i campi del punto minimo del gradiente della regola di formattazione condizionale.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from red to green to blue, based on their values in comparison to // the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
color | String | Il colore del punto minimo da impostare. |
type | InterpolationType | Il tipo di interpolazione del punto minimo da impostare. |
value | String | Il valore del punto minimo da impostare. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setItalic(italic)
Imposta il corsivo per il testo per il formato della regola di formattazione condizionale. Se italic
è true
,
la regola mette in corsivo il testo se la condizione è soddisfatta; se false
, la regola rimuove qualsiasi
se la condizione è soddisfatta. Il corsivo viene rimosso tra null
dell'impostazione del formato
dalla regola.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their // text italic if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setItalic(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
italic | Boolean | Indica se il testo deve essere in corsivo o meno se la condizione del formato è soddisfatta.
null rimuove questa impostazione. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setRanges(ranges)
Consente di impostare uno o più intervalli a cui viene applicata questa regola di formattazione condizionale. Questa operazione sostituisce qualsiasi intervallo esistente. L'impostazione di un array vuoto cancella tutti gli intervalli esistenti. Una regola deve abbia almeno un intervallo.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 and range D4:F6 // to turn red if they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var rangeOne = sheet.getRange("A1:B3"); var rangeTwo = sheet.getRange("D4:F6"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([rangeOne, rangeTwo]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
ranges | Range[] | Gli intervalli a cui viene applicata questa regola di formattazione condizionale. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setStrikethrough(strikethrough)
Imposta il testo barrato per il formato della regola di formattazione condizionale. Se strikethrough
è
true
, la regola barra il testo se la condizione è soddisfatta; se false
, la regola
rimuove l'eventuale formattazione barrata esistente se la condizione è soddisfatta. Superamento tra null
l'impostazione del formato barrato viene rimossa dalla regola.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to strikethrough // their text if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setStrikethrough(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
strikethrough | Boolean | Indica se il testo deve essere barrato o meno se la condizione del formato è
met; null rimuove questa impostazione. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
setUnderline(underline)
Imposta il testo sottolineato per il formato della regola di formattazione condizionale. Se underline
è true
, la regola sottolinea il testo se la condizione è soddisfatta. se false
, la regola rimuove qualsiasi
sottolineature esistenti se la condizione è soddisfatta. Il passaggio tra null
rimuove la sottolineatura
dell'impostazione del formato
dalla regola.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to underline // their text if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setUnderline(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
underline | Boolean | Indica se il testo deve essere sottolineato o meno se la condizione del formato è soddisfatta.
null rimuove questa impostazione. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenCellEmpty()
Imposta la regola di formattazione condizionale da attivare quando la cella è vuota.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they are empty. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenCellEmpty() .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenCellNotEmpty()
Imposta la regola di formattazione condizionale da attivare quando la cella non è vuota.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they are not empty. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenCellNotEmpty() .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenDateAfter(date)
Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è successiva al valore specificato.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date after 11/4/1993. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateAfter(new Date("11/4/1993")) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | La data più recente. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenDateAfter(date)
Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è successiva alla data relativa specificata.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date after today. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | RelativeDate | L'ultima data in relazione al tipo di data selezionato. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenDateBefore(date)
Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente a quella specificata.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date before 11/4/1993. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateBefore(new Date("11/4/1993")) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | La prima data non accettabile. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenDateBefore(date)
Imposta la regola di formattazione condizionale in modo che venga attivata quando una data è precedente alla data relativa specificata.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date before today. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | RelativeDate | L'ultima data in relazione al tipo di data selezionato. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenDateEqualTo(date)
Imposta la regola di formattazione condizionale da attivare quando una data corrisponde a quella specificata.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain the date 11/4/1993. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateEqualTo(new Date("11/4/1993")) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | Date | L'unica data accettabile. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenDateEqualTo(date)
Imposta la regola di formattazione condizionale da attivare quando una data corrisponde alla data relativa specificata.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain todays date. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
date | RelativeDate | L'ultima data in relazione al tipo di data selezionato. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenFormulaSatisfied(formula)
Imposta la regola di formattazione condizionale da attivare quando la formula specificata restituisce true
.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they satisfy the condition "=EQ(B4, C3)". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenFormulaSatisfied("=EQ(B4, C3)") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
formula | String | Una formula personalizzata che restituisce true se l'input è valido. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenNumberBetween(start, end)
Imposta la regola di formattazione condizionale da attivare quando un numero rientra tra due o è uno di due i valori specificati.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il valore accettabile più basso. |
end | Number | Il valore accettabile più alto. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenNumberEqualTo(number)
Imposta la regola di formattazione condizionale da attivare quando un numero è uguale al valore specificato.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain the number 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | L'unico valore accettabile. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenNumberGreaterThan(number)
Imposta la regola di formattazione condizionale da attivare quando un numero è maggiore del valore specificato.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red // if they contain a number greater than 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberGreaterThan(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore non accettabile più alto. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenNumberGreaterThanOrEqualTo(number)
Imposta la regola di formattazione condizionale da attivare quando un numero è maggiore o uguale al valore specificato valore.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number greater than or equal to 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberGreaterThanOrEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore accettabile più basso. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenNumberLessThan(number)
Imposta la regola di formattazione condizionale in modo che venga attivata quando un numero è inferiore a quello specificato valore.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number less than 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberLessThan(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore non accettabile più basso. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenNumberLessThanOrEqualTo(number)
Imposta la regola di formattazione condizionale da attivare quando un numero è minore o uguale al valore specificato valore.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number less than or equal to 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberLessThanOrEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | Il valore accettabile più alto. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenNumberNotBetween(start, end)
Imposta la regola di formattazione condizionale da attivare quando un numero non rientra tra quelli e non è nessuno dei due valori due valori specificati.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number not between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberNotBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
start | Number | Il valore non accettabile più basso. |
end | Number | Il valore non accettabile più alto. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenNumberNotEqualTo(number)
Imposta la regola di formattazione condizionale da attivare quando un numero è diverso dal valore specificato.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they don't contain the number 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberNotEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
number | Number | L'unico valore inaccettabile. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenTextContains(text)
Imposta la regola di formattazione condizionale da attivare quando l'input contiene il valore specificato.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextContains("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il valore che deve contenere l'input. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenTextDoesNotContain(text)
Imposta la regola di formattazione condizionale da attivare quando l'input non contiene il valore.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they don't contain the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextDoesNotContain("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Il valore che l'input non deve contenere. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenTextEndsWith(text)
Imposta la regola di formattazione condizionale da attivare quando l'input termina con il valore specificato.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they end with the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEndsWith("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Testo da confrontare con la fine della stringa. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenTextEqualTo(text)
Imposta la regola di formattazione condizionale da attivare quando l'input è uguale al valore specificato.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they have text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | L'unico valore accettabile. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
whenTextStartsWith(text)
Imposta la regola di formattazione condizionale da attivare quando l'input inizia con il valore specificato.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they start with the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextStartsWith("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
text | String | Testo da confrontare con l'inizio della stringa. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento
withCriteria(criteria, args)
Imposta la regola di formattazione condizionale sui criteri definiti dai valori BooleanCriteria
,
tipicamente ricavato da criteria
e arguments
di un
una regola esistente.
// Adds a new conditional format rule that is a copy of the first active // conditional format rule, except it instead sets its cells to have a black // background color. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); var booleanCondition = rules[0].getBooleanCondition(); if (booleanCondition != null) { var rule = SpreadsheetApp.newConditionalFormatRule() .withCriteria(booleanCondition.getCriteriaType(), booleanCondition.getCriteriaValues()) .setBackground("#000000") .setRanges(rule.getRanges()) .build(); rules.push(rule); } sheet.setConditionalFormatRules(rules);
Parametri
Nome | Tipo | Descrizione |
---|---|---|
criteria | BooleanCriteria | Il tipo di criteri del formato condizionale. |
args | Object[] | Un array di argomenti appropriati al tipo di criteri; il numero di argomenti e
il loro tipo corrisponde al metodo when...() corrispondente sopra indicato. |
Invio
ConditionalFormatRuleBuilder
: lo strumento di creazione, per il concatenamento