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