Compilateur pour les règles de mise en forme conditionnelle.
// 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);
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
build() | ConditionalFormatRule | Construit une règle de mise en forme conditionnelle à partir des paramètres appliqués au compilateur. |
copy() | ConditionalFormatRuleBuilder | Affiche un préréglage de l'outil de création de règle avec les paramètres de cette règle. |
getBooleanCondition() | BooleanCondition | Récupère les informations BooleanCondition de la règle si celle-ci utilise des critères de condition booléens. |
getGradientCondition() | GradientCondition | Récupère les informations GradientCondition de la règle si cette règle utilise des critères de condition de gradient. |
getRanges() | Range[] | Récupère les plages auxquelles cette règle de mise en forme conditionnelle est appliquée. |
setBackground(color) | ConditionalFormatRuleBuilder | Définit la couleur d'arrière-plan du format de la règle de mise en forme conditionnelle. |
setBackgroundObject(color) | ConditionalFormatRuleBuilder | Définit la couleur d'arrière-plan du format de la règle de mise en forme conditionnelle. |
setBold(bold) | ConditionalFormatRuleBuilder | Définit la mise en gras du texte pour le format de la règle de mise en forme conditionnelle. |
setFontColor(color) | ConditionalFormatRuleBuilder | Définit la couleur de la police pour le format de la règle de mise en forme conditionnelle. |
setFontColorObject(color) | ConditionalFormatRuleBuilder | Définit la couleur de la police pour le format de la règle de mise en forme conditionnelle. |
setGradientMaxpoint(color) | ConditionalFormatRuleBuilder | Efface la valeur du point maximal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur maximale des plages de la règle. |
setGradientMaxpointObject(color) | ConditionalFormatRuleBuilder | Efface la valeur du point maximal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur maximale des plages de la règle. |
setGradientMaxpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Définit les champs de point maximal du dégradé de la règle de mise en forme conditionnelle. |
setGradientMaxpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Définit les champs de point maximal du dégradé de la règle de mise en forme conditionnelle. |
setGradientMidpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Définit les champs de point médian du dégradé de la règle de mise en forme conditionnelle. |
setGradientMidpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Définit les champs de point médian du dégradé de la règle de mise en forme conditionnelle. |
setGradientMinpoint(color) | ConditionalFormatRuleBuilder | Efface la valeur du point minimal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur minimale des plages de la règle. |
setGradientMinpointObject(color) | ConditionalFormatRuleBuilder | Efface la valeur du point minimal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur minimale des plages de la règle. |
setGradientMinpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Définit les champs de point minimal du dégradé de la règle de mise en forme conditionnelle. |
setGradientMinpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Définit les champs de point minimal du dégradé de la règle de mise en forme conditionnelle. |
setItalic(italic) | ConditionalFormatRuleBuilder | Met le texte en italique pour le format de la règle de mise en forme conditionnelle. |
setRanges(ranges) | ConditionalFormatRuleBuilder | Définit une ou plusieurs plages auxquelles cette règle de mise en forme conditionnelle est appliquée. |
setStrikethrough(strikethrough) | ConditionalFormatRuleBuilder | Définit le texte barré pour le format de la règle de mise en forme conditionnelle. |
setUnderline(underline) | ConditionalFormatRuleBuilder | Définit le texte souligné pour le format de la règle de mise en forme conditionnelle. |
whenCellEmpty() | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsque la cellule est vide. |
whenCellNotEmpty() | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsque la cellule n'est pas vide. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est postérieure à la valeur donnée. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est postérieure à la date relative donnée. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est antérieure à la date donnée. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est antérieure à la date relative donnée. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est égale à la date donnée. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est égale à la date relative donnée. |
whenFormulaSatisfied(formula) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsque la formule donnée renvoie la valeur true . |
whenNumberBetween(start, end) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre se trouve entre deux valeurs spécifiées ou correspond à l'une des deux. |
whenNumberEqualTo(number) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est égal à la valeur donnée. |
whenNumberGreaterThan(number) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est supérieur à la valeur donnée. |
whenNumberGreaterThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est supérieur ou égal à la valeur donnée. |
whenNumberLessThan(number) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle conditionnelle à déclencher lorsqu'un nombre est inférieur à la valeur donnée. |
whenNumberLessThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est inférieur ou égal à la valeur donnée. |
whenNumberNotBetween(start, end) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre ne se trouve pas entre deux valeurs spécifiées et n'en est aucune. |
whenNumberNotEqualTo(number) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre n'est pas égal à la valeur donnée. |
whenTextContains(text) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée contient la valeur donnée. |
whenTextDoesNotContain(text) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée ne contient pas la valeur donnée. |
whenTextEndsWith(text) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée se termine par la valeur donnée. |
whenTextEqualTo(text) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée est égale à la valeur donnée. |
whenTextStartsWith(text) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée commence par la valeur donnée. |
withCriteria(criteria, args) | ConditionalFormatRuleBuilder | Définit la règle de mise en forme conditionnelle sur des critères définis par des valeurs BooleanCriteria , généralement extraites de l'élément criteria et arguments d'une règle existante. |
Documentation détaillée
build()
Construit une règle de mise en forme conditionnelle à partir des paramètres appliqués au compilateur.
Renvois
ConditionalFormatRule
: représentation de la règle de mise en forme conditionnelle
copy()
Affiche un préréglage de l'outil de création de règle avec les paramètres de cette règle.
Renvois
ConditionalFormatRuleBuilder
: outil de création basé sur les paramètres de cette règle
getBooleanCondition()
Récupère les informations BooleanCondition
de la règle si celle-ci utilise des critères de condition booléens. Sinon, renvoie 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()); }
Renvois
BooleanCondition
: objet de condition booléenne, ou null
si la règle n'utilise pas de condition booléenne.
getGradientCondition()
Récupère les informations GradientCondition
de la règle si cette règle utilise des critères de condition de gradient. Sinon, renvoie 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()); }
Renvois
GradientCondition
: objet de condition de gradient, ou null
si la règle n'utilise pas de condition de gradient.
getRanges()
Récupère les plages auxquelles cette règle de mise en forme conditionnelle est appliquée.
// 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()); }
Renvois
Range[]
: plages auxquelles cette règle de mise en forme conditionnelle est appliquée.
setBackground(color)
Définit la couleur d'arrière-plan du format de la règle de mise en forme conditionnelle. La transmission de null
supprime de la règle le paramètre de format de la couleur d'arrière-plan.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | String | Couleur ou null à effacer. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setBackgroundObject(color)
Définit la couleur d'arrière-plan du format de la règle de mise en forme conditionnelle. La transmission de null
supprime de la règle le paramètre de format de la couleur d'arrière-plan.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | Color | Objet couleur ou null à effacer. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage.
setBold(bold)
Définit la mise en gras du texte pour le format de la règle de mise en forme conditionnelle. Si bold
correspond à true
, la règle met le texte en gras si la condition est remplie. Si false
, la règle supprime toute mise en gras existante si la condition est remplie. Si vous transmettez null
, le paramètre de mise en gras est supprimé de la règle.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
bold | Boolean | Indique si le texte doit être en gras si la condition de mise en forme est remplie. null supprime ce paramètre. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setFontColor(color)
Définit la couleur de la police pour le format de la règle de mise en forme conditionnelle. Si vous transmettez null
, le paramètre de format de couleur de police est supprimé de la règle.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | String | Couleur ou null à effacer. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setFontColorObject(color)
Définit la couleur de la police pour le format de la règle de mise en forme conditionnelle. Si vous transmettez null
, le paramètre de format de couleur de police est supprimé de la règle.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | Color | Objet couleur ou null à effacer. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage.
setGradientMaxpoint(color)
Efface la valeur du point maximal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur maximale des plages de la règle. Définit également la couleur du point maximal du dégradé sur la couleur d'entrée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | String | Couleur du point maximal à définir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setGradientMaxpointObject(color)
Efface la valeur du point maximal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur maximale des plages de la règle. Définit également la couleur du point maximal du dégradé sur la couleur d'entrée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | Color | Objet couleur du point maximal à définir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage.
setGradientMaxpointObjectWithValue(color, type, value)
Définit les champs de point maximal du dégradé de la règle de mise en forme conditionnelle.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | Color | Couleur du point maximal à définir. |
type | InterpolationType | Type d'interpolation du point maximal à définir. |
value | String | Valeur du point maximal à définir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage.
setGradientMaxpointWithValue(color, type, value)
Définit les champs de point maximal du dégradé de la règle de mise en forme conditionnelle.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | String | Couleur du point maximal à définir. |
type | InterpolationType | Type d'interpolation du point maximal à définir. |
value | String | Valeur du point maximal à définir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setGradientMidpointObjectWithValue(color, type, value)
Définit les champs de point médian du dégradé de la règle de mise en forme conditionnelle. Efface tous les champs de point médian si le type d'interpolation transmis est 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | Color | Couleur du point médian à définir. |
type | InterpolationType | Type d'interpolation du point médian à définir ou null à effacer. |
value | String | Valeur du point médian à définir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage.
setGradientMidpointWithValue(color, type, value)
Définit les champs de point médian du dégradé de la règle de mise en forme conditionnelle. Efface tous les champs de point médian si le type d'interpolation transmis est 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | String | Couleur du point médian à définir. |
type | InterpolationType | Type d'interpolation du point médian à définir ou null à effacer. |
value | String | Valeur du point médian à définir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setGradientMinpoint(color)
Efface la valeur du point minimal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur minimale des plages de la règle. Définit également la couleur du point minimal du dégradé sur la couleur d'entrée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | String | Couleur du point minimal à définir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setGradientMinpointObject(color)
Efface la valeur du point minimal du dégradé de la règle de mise en forme conditionnelle et utilise à la place la valeur minimale des plages de la règle. Définit également la couleur du point minimal du dégradé sur la couleur d'entrée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | Color | Objet couleur du point minimal à définir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage.
setGradientMinpointObjectWithValue(color, type, value)
Définit les champs de point minimal du dégradé de la règle de mise en forme conditionnelle.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | Color | Couleur du point minimal à définir. |
type | InterpolationType | Type d'interpolation du point minimal à définir. |
value | String | Valeur minimale à définir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage.
setGradientMinpointWithValue(color, type, value)
Définit les champs de point minimal du dégradé de la règle de mise en forme conditionnelle.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
color | String | Couleur du point minimal à définir. |
type | InterpolationType | Type d'interpolation du point minimal à définir. |
value | String | Valeur minimale à définir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setItalic(italic)
Met le texte en italique pour le format de la règle de mise en forme conditionnelle. Si italic
est défini sur true
, la règle met le texte en italique si la condition est remplie. Si false
, la règle supprime toute italique existante si la condition est remplie. Si vous transmettez null
, le paramètre de mise en italique est supprimé de la règle.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
italic | Boolean | Indique si le texte doit être mis en italique si la condition de mise en forme est remplie. null supprime ce paramètre. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setRanges(ranges)
Définit une ou plusieurs plages auxquelles cette règle de mise en forme conditionnelle est appliquée. Cette opération remplace toutes les plages existantes. Définir un tableau vide efface toutes les plages existantes. Une règle doit comporter au moins une plage.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
ranges | Range[] | Plages auxquelles cette règle de mise en forme conditionnelle est appliquée. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setStrikethrough(strikethrough)
Définit le texte barré pour le format de la règle de mise en forme conditionnelle. Si strikethrough
est défini sur true
, la règle barre le texte si la condition est remplie. Si la valeur est false
, la règle supprime toute mise en forme barrée existante si la condition est remplie. Si vous transmettez null
, le paramètre de format barré est supprimé de la règle.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
strikethrough | Boolean | Indique si le texte doit être barré si la condition de mise en forme est remplie. null supprime ce paramètre. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
setUnderline(underline)
Définit le texte souligné pour le format de la règle de mise en forme conditionnelle. Si underline
correspond à true
, la règle souligne le texte si la condition est remplie. Si la valeur est false
, tous les traits de soulignement existants sont supprimés si la condition est remplie. Si vous transmettez null
, le paramètre de format de soulignement est supprimé de la règle.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
underline | Boolean | Indique si le texte doit être souligné si la condition de mise en forme est remplie. null supprime ce paramètre. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenCellEmpty()
Définit la règle de mise en forme conditionnelle à déclencher lorsque la cellule est vide.
// 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);
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenCellNotEmpty()
Définit la règle de mise en forme conditionnelle à déclencher lorsque la cellule n'est pas vide.
// 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);
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenDateAfter(date)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est postérieure à la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | Date | La dernière date. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenDateAfter(date)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est postérieure à la date relative donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | RelativeDate | Date la plus récente par rapport au type de date sélectionné. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenDateBefore(date)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est antérieure à la date donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | Date | Première date non autorisée. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenDateBefore(date)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est antérieure à la date relative donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | RelativeDate | Date la plus récente par rapport au type de date sélectionné. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenDateEqualTo(date)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est égale à la date donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | Date | Seule date acceptable. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenDateEqualTo(date)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est égale à la date relative donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
date | RelativeDate | Date la plus récente par rapport au type de date sélectionné. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenFormulaSatisfied(formula)
Définit la règle de mise en forme conditionnelle à déclencher lorsque la formule donnée renvoie la valeur 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);
Paramètres
Nom | Type | Description |
---|---|---|
formula | String | Formule personnalisée qui renvoie la valeur true si l'entrée est valide. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenNumberBetween(start, end)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre se trouve entre deux valeurs spécifiées ou correspond à l'une des deux.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
start | Number | Valeur acceptable la plus basse. |
end | Number | Valeur acceptable la plus élevée. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenNumberEqualTo(number)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est égal à la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Seule valeur acceptable. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenNumberGreaterThan(number)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est supérieur à la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Valeur inacceptable la plus élevée. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenNumberGreaterThanOrEqualTo(number)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est supérieur ou égal à la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Valeur acceptable la plus basse. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenNumberLessThan(number)
Définit la règle de mise en forme conditionnelle conditionnelle à déclencher lorsqu'un nombre est inférieur à la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Valeur la plus basse inacceptable. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenNumberLessThanOrEqualTo(number)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est inférieur ou égal à la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Valeur acceptable la plus élevée. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenNumberNotBetween(start, end)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre ne se trouve pas entre deux valeurs spécifiées et n'en est aucune.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
start | Number | Valeur la plus basse inacceptable. |
end | Number | Valeur inacceptable la plus élevée. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenNumberNotEqualTo(number)
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre n'est pas égal à la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
number | Number | Seule valeur non autorisée. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenTextContains(text)
Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée contient la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Valeur que l'entrée doit contenir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenTextDoesNotContain(text)
Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée ne contient pas la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Valeur que l'entrée ne doit pas contenir. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenTextEndsWith(text)
Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée se termine par la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Texte à comparer à la fin de la chaîne. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenTextEqualTo(text)
Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée est égale à la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Seule valeur acceptable. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
whenTextStartsWith(text)
Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée commence par la valeur donnée.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
text | String | Texte à comparer au début de la chaîne. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage
withCriteria(criteria, args)
Définit la règle de mise en forme conditionnelle sur des critères définis par des valeurs BooleanCriteria
, généralement extraites de l'élément criteria
et arguments
d'une règle existante.
// 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);
Paramètres
Nom | Type | Description |
---|---|---|
criteria | BooleanCriteria | Type de critère de mise en forme conditionnelle. |
args | Object[] | Tableau d'arguments adapté au type de critère. Le nombre d'arguments et leur type correspondent à la méthode when...() correspondante ci-dessus. |
Renvois
ConditionalFormatRuleBuilder
: compilateur, pour le chaînage