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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
build() | Conditional | Construit une règle de mise en forme conditionnelle à partir des paramètres appliqués au générateur. |
copy() | Conditional | Renvoie un préréglage du générateur de règles avec les paramètres de cette règle. |
get | Boolean | Récupère les informations Boolean de la règle si elle utilise des critères de condition booléenne. |
get | Gradient | Récupère les informations Gradient de la règle, si celle-ci utilise des critères de condition de gradient. |
get | Range[] | Récupère les plages auxquelles cette règle de mise en forme conditionnelle est appliquée. |
set | Conditional | Définit la couleur d'arrière-plan du format de la règle de mise en forme conditionnelle. |
set | Conditional | Définit la couleur d'arrière-plan du format de la règle de mise en forme conditionnelle. |
set | Conditional | Définit la mise en gras du texte pour le format de la règle de mise en forme conditionnelle. |
set | Conditional | Définit la couleur de police du format de la règle de mise en forme conditionnelle. |
set | Conditional | Définit la couleur de police du format de la règle de mise en forme conditionnelle. |
set | Conditional | Efface la valeur maximale 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. |
set | Conditional | Efface la valeur maximale 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. |
set | Conditional | Définit les champs de point maximal du dégradé de la règle de mise en forme conditionnelle. |
set | Conditional | Définit les champs de point maximal du dégradé de la règle de mise en forme conditionnelle. |
set | Conditional | Définit les champs de point médian du dégradé de la règle de mise en forme conditionnelle. |
set | Conditional | Définit les champs de point médian du dégradé de la règle de mise en forme conditionnelle. |
set | Conditional | Efface la valeur du point médian 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. |
set | Conditional | Efface la valeur du point médian 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. |
set | Conditional | Définit les champs de point minimal du dégradé de la règle de mise en forme conditionnelle. |
set | Conditional | Définit les champs de point minimal du dégradé de la règle de mise en forme conditionnelle. |
set | Conditional | Définit l'italique pour le texte de la règle de mise en forme conditionnelle. |
set | Conditional | Définit une ou plusieurs plages auxquelles cette règle de mise en forme conditionnelle est appliquée. |
set | Conditional | Définit le texte barré pour le format de la règle de mise en forme conditionnelle. |
set | Conditional | Définit le soulignement du texte pour le format de la règle de mise en forme conditionnelle. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsque la cellule est vide. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsque la cellule n'est pas vide. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est postérieure à la valeur indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est postérieure à la date relative indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est antérieure à la date indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est antérieure à la date relative indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est égale à la date indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est égale à la date relative indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsque la formule donnée renvoie true. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre se situe entre deux valeurs spécifiées ou est égal à l'une d'elles. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est égal à la valeur indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est supérieur à la valeur indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est supérieur ou égal à la valeur indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est inférieur à la valeur indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est inférieur ou égal à la valeur indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre ne se situe pas entre deux valeurs spécifiées et n'est égal à aucune d'elles. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre n'est pas égal à la valeur indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée contient la valeur spécifiée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée ne contient pas la valeur indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée se termine par la valeur indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée est égale à la valeur indiquée. |
when | Conditional | Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée commence par la valeur indiquée. |
with | Conditional | Définit la règle de mise en forme conditionnelle sur les critères définis par les valeurs Boolean, généralement tirées des 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 générateur.
Renvois
Conditional : représentation de la règle de mise en forme conditionnelle.
copy()
Renvoie un préréglage du générateur de règles avec les paramètres de cette règle.
Renvois
Conditional : compilateur basé sur les paramètres de cette règle.
get
Récupère les informations Boolean de la règle si elle utilise des critères de condition booléenne. Sinon, renvoie null.
// Log the boolean criteria type of the first conditional format rules of a // sheet. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const booleanCondition = rule.getBooleanCondition(); if (booleanCondition != null) { Logger.log(booleanCondition.getCriteriaType()); }
Renvois
Boolean : objet de condition booléenne ou null si la règle n'utilise pas de condition booléenne.
get
Récupère les informations Gradient de la règle, si celle-ci 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. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const gradientCondition = rule.getGradientCondition(); if (gradientCondition != null) { // Assume the color has ColorType.RGB. Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString()); }
Renvois
Gradient : objet de condition de dégradé ou null si la règle n'utilise pas de condition de dégradé.
get
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. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const ranges = rule.getRanges(); for (let 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.
set
Définit la couleur d'arrière-plan du format de la règle de mise en forme conditionnelle. Si vous transmettez null, le paramètre de format de couleur d'arrière-plan est supprimé de la règle.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // set their background color to red if the cell has text equal to "hello". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | String | La couleur souhaitée ou null pour effacer. |
Renvois
Conditional : compilateur, pour le chaînage.
set
Définit la couleur d'arrière-plan du format de la règle de mise en forme conditionnelle. Si vous transmettez null, le paramètre de format de couleur d'arrière-plan est supprimé de la règle.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // set their background color to theme background color if the cell has text // equal to "hello". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setBackground(color) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | Color | Objet de couleur souhaité ou null pour effacer. |
Renvois
Conditional : compilateur, pour le chaînage.
set
Définit la mise en gras du texte pour le format de la règle de mise en forme conditionnelle. Si bold est défini sur true, la règle met le texte en gras si la condition est remplie. Si bold est défini sur 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 forme 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setBold(true) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
bold | Boolean | Indique si le texte doit être mis en gras lorsque la condition de format est remplie. null supprime ce paramètre. |
Renvois
Conditional : compilateur, pour le chaînage.
set
Définit la couleur de police du 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setFontColor('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | String | La couleur souhaitée ou null pour effacer. |
Renvois
Conditional : compilateur, pour le chaînage.
set
Définit la couleur de police du 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setFontColor(color) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | Color | Objet de couleur souhaité ou null pour effacer. |
Renvois
Conditional : compilateur, pour le chaînage.
set
Efface la valeur maximale 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint('#FF0000') .setGradientMinpoint('#FFFFFF') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | String | Couleur du point maximal à définir. |
Renvois
Conditional : compilateur, pour le chaînage.
set
Efface la valeur maximale 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const textColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); const backgroundColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint(textColor) .setGradientMinpoint(backgroundColor) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | Color | Objet de couleur du point maximal à définir. |
Renvois
Conditional : compilateur, pour le chaînage.
set
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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); const color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); const color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( color1, SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( color2, SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( color3, SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | Color | Couleur du point maximal à définir. |
type | Interpolation | Type d'interpolation maxpoint à définir. |
value | String | Valeur maxpoint à définir. |
Renvois
Conditional : compilateur, pour le chaînage.
set
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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( '#0000FF', SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( '#00FF00', SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( '#FF0000', SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | String | Couleur du point maximal à définir. |
type | Interpolation | Type d'interpolation maxpoint à définir. |
value | String | Valeur maxpoint à définir. |
Renvois
Conditional : compilateur, pour le chaînage.
set
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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); const color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); const color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( color1, SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( color2, SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( color3, SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | Color | Couleur du point médian à définir. |
type | Interpolation | Type d'interpolation du point médian à définir ou null pour effacer. |
value | String | Valeur du point médian à définir. |
Renvois
Conditional : compilateur, pour le chaînage.
set
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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( '#0000FF', SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( '#00FF00', SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( '#FF0000', SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | String | Couleur du point médian à définir. |
type | Interpolation | Type d'interpolation du point médian à définir ou null pour effacer. |
value | String | Valeur du point médian à définir. |
Renvois
Conditional : compilateur, pour le chaînage.
set
Efface la valeur du point médian 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint('#FF0000') .setGradientMinpoint('#FFFFFF') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | String | Couleur du point minimal à définir. |
Renvois
Conditional : compilateur, pour le chaînage.
set
Efface la valeur du point médian 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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const textColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); const backgroundColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint(textColor) .setGradientMinpoint(backgroundColor) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | Color | Objet de couleur du point minimal à définir. |
Renvois
Conditional : compilateur, pour le chaînage.
set
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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); const color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); const color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( color1, SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( color2, SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( color3, SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | Color | Couleur du point minimal à définir. |
type | Interpolation | Type d'interpolation minpoint à définir. |
value | String | Valeur minpoint à définir. |
Renvois
Conditional : compilateur, pour le chaînage.
set
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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue( '#0000FF', SpreadsheetApp.InterpolationType.NUMBER, '100', ) .setGradientMidpointWithValue( '#00FF00', SpreadsheetApp.InterpolationType.NUMBER, '50', ) .setGradientMinpointWithValue( '#FF0000', SpreadsheetApp.InterpolationType.NUMBER, '0', ) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
color | String | Couleur du point minimal à définir. |
type | Interpolation | Type d'interpolation minpoint à définir. |
value | String | Valeur minpoint à définir. |
Renvois
Conditional : compilateur, pour le chaînage.
set
Définit l'italique pour le texte 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 italic est défini sur false, la règle supprime toute mise en italique existante si la condition est remplie. Si vous transmettez null, le paramètre de mise en forme 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setItalic(true) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
italic | Boolean | Indique si le texte doit être mis en italique si la condition de format est remplie. null supprime ce paramètre. |
Renvois
Conditional : compilateur, pour le chaînage.
set
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. const sheet = SpreadsheetApp.getActiveSheet(); const rangeOne = sheet.getRange('A1:B3'); const rangeTwo = sheet.getRange('D4:F6'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground('#FF0000') .setRanges([rangeOne, rangeTwo]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
ranges | Range[] | Plages auxquelles s'applique cette règle de mise en forme conditionnelle. |
Renvois
Conditional : compilateur, pour le chaînage.
set
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 strikethrough est défini sur 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 mise en forme barrée 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setStrikethrough(true) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
strikethrough | Boolean | Indique si le texte doit être barré lorsque la condition de mise en forme est remplie. null supprime ce paramètre. |
Renvois
Conditional : compilateur, pour le chaînage.
set
Définit le soulignement du texte pour le format de la règle de mise en forme conditionnelle. Si underline est défini sur true, la règle souligne le texte si la condition est remplie. Si false est défini, la règle supprime tous les soulignements existants 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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setUnderline(true) .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
underline | Boolean | Indique si le texte doit être souligné lorsque la condition de mise en forme est remplie. null supprime ce paramètre. |
Renvois
Conditional : compilateur, pour le chaînage.
when
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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenCellEmpty() .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Renvois
Conditional : compilateur, pour le chaînage.
when
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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenCellNotEmpty() .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est postérieure à la valeur indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateAfter(new Date('11/4/1993')) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
date | Date | Date la plus récente. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est postérieure à la date relative indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
date | Relative | Date la plus récente par rapport au type de date sélectionné. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est antérieure à la date indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateBefore(new Date('11/4/1993')) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
date | Date | Date la plus ancienne inacceptable. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est antérieure à la date relative indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
date | Relative | Date la plus récente par rapport au type de date sélectionné. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est égale à la date indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateEqualTo(new Date('11/4/1993')) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
date | Date | Seule cette date est acceptée. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'une date est égale à la date relative indiquée.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // turn red if they contain todays date. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
date | Relative | Date la plus récente par rapport au type de date sélectionné. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsque la formule donnée renvoie true.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // turn red if they satisfy the condition "=EQ(B4, C3)". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenFormulaSatisfied('=EQ(B4, C3)') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
formula | String | Formule personnalisée qui renvoie true si l'entrée est valide. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre se situe entre deux valeurs spécifiées ou est égal à l'une d'elles.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // turn red if they contain a number between 1 and 10. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
start | Number | Valeur minimale acceptable. |
end | Number | Valeur acceptable la plus élevée. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est égal à la valeur indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberEqualTo(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
number | Number | La seule valeur acceptable. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est supérieur à la valeur indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberGreaterThan(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
number | Number | Valeur inacceptable la plus élevée. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est supérieur ou égal à la valeur indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberGreaterThanOrEqualTo(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
number | Number | Valeur minimale acceptable. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est inférieur à la valeur indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberLessThan(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
number | Number | Valeur la plus faible inacceptable. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre est inférieur ou égal à la valeur indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberLessThanOrEqualTo(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
number | Number | Valeur acceptable la plus élevée. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre ne se situe pas entre deux valeurs spécifiées et n'est égal à aucune d'elles.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to // turn red if they contain a number not between 1 and 10. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberNotBetween(1, 10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
start | Number | Valeur la plus faible inacceptable. |
end | Number | Valeur inacceptable la plus élevée. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsqu'un nombre n'est pas égal à la valeur indiqué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. const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberNotEqualTo(10) .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
number | Number | La seule valeur non autorisée. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée contient la valeur spécifié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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextContains('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
text | String | Valeur que l'entrée doit contenir. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée ne contient pas la valeur indiqué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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextDoesNotContain('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
text | String | Valeur que l'entrée ne doit pas contenir. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée se termine par la valeur indiqué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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEndsWith('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
text | String | Texte à comparer à la fin de la chaîne. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée est égale à la valeur indiqué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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
text | String | La seule valeur acceptable. |
Renvois
Conditional : compilateur, pour le chaînage.
when
Définit la règle de mise en forme conditionnelle à déclencher lorsque l'entrée commence par la valeur indiqué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". const sheet = SpreadsheetApp.getActiveSheet(); const range = sheet.getRange('A1:B3'); const rule = SpreadsheetApp.newConditionalFormatRule() .whenTextStartsWith('hello') .setBackground('#FF0000') .setRanges([range]) .build(); const rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
text | String | Texte à comparer au début de la chaîne. |
Renvois
Conditional : compilateur, pour le chaînage.
with
Définit la règle de mise en forme conditionnelle sur les critères définis par les valeurs Boolean, généralement tirées des 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. const sheet = SpreadsheetApp.getActiveSheet(); const rules = sheet.getConditionalFormatRules(); const booleanCondition = rules[0].getBooleanCondition(); if (booleanCondition != null) { const rule = SpreadsheetApp.newConditionalFormatRule() .withCriteria( booleanCondition.getCriteriaType(), booleanCondition.getCriteriaValues(), ) .setBackground('#000000') .setRanges(rules[0].getRanges()) .build(); rules.push(rule); } sheet.setConditionalFormatRules(rules);
Paramètres
| Nom | Type | Description |
|---|---|---|
criteria | Boolean | Type de critère de mise en forme conditionnelle. |
args | Object[] | Tableau d'arguments correspondant au type de critère. Le nombre d'arguments et leur type correspondent à la méthode when...() correspondante ci-dessus. |
Renvois
Conditional : compilateur, pour le chaînage.