Compilador para reglas de formato condicional.
// 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étodos
Método | Tipo de datos que se muestra | Descripción breve |
---|---|---|
build() | ConditionalFormatRule | Construye una regla de formato condicional a partir de la configuración aplicada al compilador. |
copy() | ConditionalFormatRuleBuilder | Muestra un ajuste predeterminado del creador de reglas con la configuración de esta regla. |
getBooleanCondition() | BooleanCondition | Recupera la información BooleanCondition de la regla si esta usa criterios de condición booleano. |
getGradientCondition() | GradientCondition | Recupera la información de GradientCondition de la regla, si esta usa criterios de condición de gradiente. |
getRanges() | Range[] | Recupera los rangos a los que se aplica esta regla de formato condicional. |
setBackground(color) | ConditionalFormatRuleBuilder | Establece el color de fondo para el formato de la regla de formato condicional. |
setBackgroundObject(color) | ConditionalFormatRuleBuilder | Establece el color de fondo para el formato de la regla de formato condicional. |
setBold(bold) | ConditionalFormatRuleBuilder | Establece la negrita del texto para el formato de la regla de formato condicional. |
setFontColor(color) | ConditionalFormatRuleBuilder | Establece el color de fuente para el formato de la regla de formato condicional. |
setFontColorObject(color) | ConditionalFormatRuleBuilder | Establece el color de fuente para el formato de la regla de formato condicional. |
setGradientMaxpoint(color) | ConditionalFormatRuleBuilder | Borra el valor de punto máximo de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo de los rangos de la regla. |
setGradientMaxpointObject(color) | ConditionalFormatRuleBuilder | Borra el valor de punto máximo de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo de los rangos de la regla. |
setGradientMaxpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Establece los campos de punto máximo de gradiente de la regla de formato condicional. |
setGradientMaxpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Establece los campos de punto máximo de gradiente de la regla de formato condicional. |
setGradientMidpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Configura los campos de punto medio de gradiente de la regla de formato condicional. |
setGradientMidpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Configura los campos de punto medio de gradiente de la regla de formato condicional. |
setGradientMinpoint(color) | ConditionalFormatRuleBuilder | Borra el valor de punto mínimo del gradiente de la regla de formato condicional y, en su lugar, usa el valor mínimo en los rangos de la regla. |
setGradientMinpointObject(color) | ConditionalFormatRuleBuilder | Borra el valor de punto mínimo del gradiente de la regla de formato condicional y, en su lugar, usa el valor mínimo en los rangos de la regla. |
setGradientMinpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Configura los campos de punto mínimo de gradiente de la regla de formato condicional. |
setGradientMinpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Configura los campos de punto mínimo de gradiente de la regla de formato condicional. |
setItalic(italic) | ConditionalFormatRuleBuilder | Establece la cursiva de texto para el formato de la regla de formato condicional. |
setRanges(ranges) | ConditionalFormatRuleBuilder | Establece uno o más rangos a los que se aplica esta regla de formato condicional. |
setStrikethrough(strikethrough) | ConditionalFormatRuleBuilder | Establece tachado en el texto para el formato de la regla de formato condicional. |
setUnderline(underline) | ConditionalFormatRuleBuilder | Establece el subrayado de texto para el formato de la regla de formato condicional. |
whenCellEmpty() | ConditionalFormatRuleBuilder | Configura la regla de formato condicional que se activará cuando la celda esté vacía. |
whenCellNotEmpty() | ConditionalFormatRuleBuilder | Configura la regla de formato condicional que se activará cuando la celda no esté vacía. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando una fecha sea posterior al valor determinado. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando una fecha sea posterior a la fecha relativa determinada. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando una fecha sea anterior a la fecha especificada. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando una fecha sea anterior a la fecha relativa determinada. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha determinada. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha relativa determinada. |
whenFormulaSatisfied(formula) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional que se activará cuando la fórmula dada se evalúe como true . |
whenNumberBetween(start, end) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando un número se encuentre entre dos valores especificados o sea cualquiera de ellos. |
whenNumberEqualTo(number) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional que se activará cuando un número sea igual al valor determinado. |
whenNumberGreaterThan(number) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional que se activa cuando un número es mayor que el valor especificado. |
whenNumberGreaterThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional que se activa cuando un número es mayor o igual que el valor determinado. |
whenNumberLessThan(number) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando un número sea inferior al valor determinado. |
whenNumberLessThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional que se activa cuando un número es menor o igual que el valor determinado. |
whenNumberNotBetween(start, end) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando un número no se encuentre en el medio o no sea ninguno de los dos valores especificados. |
whenNumberNotEqualTo(number) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando un número no sea igual al valor especificado. |
whenTextContains(text) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando la entrada contenga el valor determinado. |
whenTextDoesNotContain(text) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando la entrada no contenga el valor determinado. |
whenTextEndsWith(text) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional que se activa cuando la entrada finaliza con el valor determinado. |
whenTextEqualTo(text) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional que se activará cuando la entrada sea igual al valor determinado. |
whenTextStartsWith(text) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional que se activa cuando la entrada comienza con el valor determinado. |
withCriteria(criteria, args) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional en los criterios definidos por los valores BooleanCriteria , que por lo general se toman de criteria y arguments de una regla existente. |
Documentación detallada
build()
Construye una regla de formato condicional a partir de la configuración aplicada al compilador.
Devolvedor
ConditionalFormatRule
: Es una representación de la regla de formato condicional.
copy()
Muestra un ajuste predeterminado del creador de reglas con la configuración de esta regla.
Devolvedor
ConditionalFormatRuleBuilder
: Es un compilador basado en la configuración de esta regla.
getBooleanCondition()
Recupera la información BooleanCondition
de la regla si esta usa criterios de condición booleano. De lo contrario, muestra 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()); }
Devolvedor
BooleanCondition
: Es el objeto de condición booleana, o bien null
si la regla no usa una condición booleana.
getGradientCondition()
Recupera la información de GradientCondition
de la regla, si esta usa criterios de condición de gradiente. De lo contrario, muestra 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()); }
Devolvedor
GradientCondition
: Es el objeto de condición de gradiente o null
si la regla no usa una condición de gradiente.
getRanges()
Recupera los rangos a los que se aplica esta regla de formato condicional.
// 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()); }
Devolvedor
Range[]
: Son los rangos a los que se aplica esta regla de formato condicional.
setBackground(color)
Establece el color de fondo para el formato de la regla de formato condicional. Pasar null
quita la configuración de formato de color de fondo de la regla.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | String | El color deseado o null para borrar. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setBackgroundObject(color)
Establece el color de fondo para el formato de la regla de formato condicional. Pasar null
quita la configuración de formato de color de fondo de la regla.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | Color | El objeto de color deseado o null para borrar. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setBold(bold)
Establece la negrita del texto para el formato de la regla de formato condicional. Si bold
es true
, la regla muestra el texto en negrita si se cumple la condición; si es false
, la regla quita cualquier elemento existente en negrita si se cumple la condición. Pasar null
quita la configuración de formato en negrita de la regla.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
bold | Boolean | Indica si el texto debe estar en negrita o no si se cumple la condición de formato. null quita esta configuración. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setFontColor(color)
Establece el color de fuente para el formato de la regla de formato condicional. Pasar null
quita la configuración de formato de color de la fuente de la regla.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | String | El color deseado o null para borrar. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setFontColorObject(color)
Establece el color de fuente para el formato de la regla de formato condicional. Pasar null
quita la configuración de formato de color de la fuente de la regla.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | Color | El objeto de color deseado o null para borrar. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setGradientMaxpoint(color)
Borra el valor de punto máximo de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo de los rangos de la regla. También establece el color de punto máximo del gradiente en el color de entrada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | String | El color de punto máximo que se establecerá. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setGradientMaxpointObject(color)
Borra el valor de punto máximo de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo de los rangos de la regla. También establece el color de punto máximo del gradiente en el color de entrada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | Color | El objeto de color de punto máximo que se establecerá. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setGradientMaxpointObjectWithValue(color, type, value)
Establece los campos de punto máximo de gradiente de la regla de formato condicional.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | Color | El color de punto máximo que se establecerá. |
type | InterpolationType | El tipo de interpolación de punto máximo que se establecerá. |
value | String | El valor de punto máximo que se establecerá. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setGradientMaxpointWithValue(color, type, value)
Establece los campos de punto máximo de gradiente de la regla de formato condicional.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | String | El color de punto máximo que se establecerá. |
type | InterpolationType | El tipo de interpolación de punto máximo que se establecerá. |
value | String | El valor de punto máximo que se establecerá. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setGradientMidpointObjectWithValue(color, type, value)
Configura los campos de punto medio de gradiente de la regla de formato condicional. Borra todos los campos de punto medio si el tipo de interpolación que se pasa es 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | Color | Color de punto medio que se establecerá. |
type | InterpolationType | Es el tipo de interpolación de punto medio que se establecerá o null para borrar. |
value | String | Es el valor de punto medio que se establecerá. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setGradientMidpointWithValue(color, type, value)
Configura los campos de punto medio de gradiente de la regla de formato condicional. Borra todos los campos de punto medio si el tipo de interpolación que se pasa es 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | String | Color de punto medio que se establecerá. |
type | InterpolationType | Es el tipo de interpolación de punto medio que se establecerá o null para borrar. |
value | String | Es el valor de punto medio que se establecerá. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setGradientMinpoint(color)
Borra el valor de punto mínimo del gradiente de la regla de formato condicional y, en su lugar, usa el valor mínimo en los rangos de la regla. También establece el color de punto mínimo del gradiente en el color de entrada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | String | Color de punto mínimo que se establecerá. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setGradientMinpointObject(color)
Borra el valor de punto mínimo del gradiente de la regla de formato condicional y, en su lugar, usa el valor mínimo en los rangos de la regla. También establece el color de punto mínimo del gradiente en el color de entrada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | Color | El objeto de color de punto mínimo que se establecerá. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setGradientMinpointObjectWithValue(color, type, value)
Configura los campos de punto mínimo de gradiente de la regla de formato condicional.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | Color | Color de punto mínimo que se establecerá. |
type | InterpolationType | Es el tipo de interpolación de punto mínimo que se establecerá. |
value | String | El valor de punto mínimo que se establecerá. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setGradientMinpointWithValue(color, type, value)
Configura los campos de punto mínimo de gradiente de la regla de formato condicional.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
color | String | Color de punto mínimo que se establecerá. |
type | InterpolationType | Es el tipo de interpolación de punto mínimo que se establecerá. |
value | String | El valor de punto mínimo que se establecerá. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setItalic(italic)
Establece la cursiva de texto para el formato de la regla de formato condicional. Si italic
es true
, la regla muestra el texto en cursiva si se cumple la condición. Si es false
, la regla quita cualquier cursiva existente si se cumple la condición. Pasar null
quita la configuración de formato cursiva de la regla.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
italic | Boolean | Indica si el texto debe aparecer en cursiva o no si se cumple la condición de formato. null quita esta configuración. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setRanges(ranges)
Establece uno o más rangos a los que se aplica esta regla de formato condicional. Esta operación reemplaza cualquier rango existente. Cuando se configura un array vacío, se borran los rangos existentes. Una regla debe tener al menos un rango.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
ranges | Range[] | Los rangos a los que se aplica esta regla de formato condicional. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setStrikethrough(strikethrough)
Establece tachado en el texto para el formato de la regla de formato condicional. Si strikethrough
es true
, la regla tacha el texto si se cumple la condición; si es false
, la regla quita cualquier formato tachado existente si se cumple la condición. Pasar null
quita la configuración de formato tachado de la regla.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
strikethrough | Boolean | Indica si el texto debe tacharse o no si se cumple la condición de formato. null quita esta configuración. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setUnderline(underline)
Establece el subrayado de texto para el formato de la regla de formato condicional. Si underline
es true
, la regla subraya el texto si se cumple la condición; si es false
, la regla quita cualquier subrayado existente si se cumple la condición. Pasar null
quita la configuración de formato de subrayado de la regla.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
underline | Boolean | Indica si el texto debe subrayarse o no si se cumple la condición de formato. null quita esta configuración. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenCellEmpty()
Configura la regla de formato condicional que se activará cuando la celda esté vacía.
// 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);
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenCellNotEmpty()
Configura la regla de formato condicional que se activará cuando la celda no esté vacía.
// 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);
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenDateAfter(date)
Configura la regla de formato condicional para que se active cuando una fecha sea posterior al valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | Date | La fecha más reciente. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenDateAfter(date)
Configura la regla de formato condicional para que se active cuando una fecha sea posterior a la fecha relativa determinada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | RelativeDate | La fecha más reciente relacionada con el tipo de fecha seleccionado. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenDateBefore(date)
Configura la regla de formato condicional para que se active cuando una fecha sea anterior a la fecha especificada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | Date | La fecha más temprana inaceptable. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenDateBefore(date)
Configura la regla de formato condicional para que se active cuando una fecha sea anterior a la fecha relativa determinada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | RelativeDate | La fecha más reciente relacionada con el tipo de fecha seleccionado. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenDateEqualTo(date)
Configura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha determinada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | Date | La única fecha aceptable. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenDateEqualTo(date)
Configura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha relativa determinada.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
date | RelativeDate | La fecha más reciente relacionada con el tipo de fecha seleccionado. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenFormulaSatisfied(formula)
Configura la regla de formato condicional que se activará cuando la fórmula dada se evalúe como 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
formula | String | Una fórmula personalizada que se evalúa como true si la entrada es válida. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberBetween(start, end)
Configura la regla de formato condicional para que se active cuando un número se encuentre entre dos valores especificados o sea cualquiera de ellos.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
start | Number | El valor aceptable más bajo. |
end | Number | Es el valor aceptable más alto. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberEqualTo(number)
Configura la regla de formato condicional que se activará cuando un número sea igual al valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | Es el único valor aceptable. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberGreaterThan(number)
Configura la regla de formato condicional que se activa cuando un número es mayor que el valor especificado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | Es el valor inaceptable más alto. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberGreaterThanOrEqualTo(number)
Configura la regla de formato condicional que se activa cuando un número es mayor o igual que el valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | El valor aceptable más bajo. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberLessThan(number)
Configura la regla de formato condicional para que se active cuando un número sea inferior al valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | El valor inaceptable más bajo. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberLessThanOrEqualTo(number)
Configura la regla de formato condicional que se activa cuando un número es menor o igual que el valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | Es el valor aceptable más alto. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberNotBetween(start, end)
Configura la regla de formato condicional para que se active cuando un número no se encuentre en el medio o no sea ninguno de los dos valores especificados.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
start | Number | El valor inaceptable más bajo. |
end | Number | Es el valor inaceptable más alto. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberNotEqualTo(number)
Configura la regla de formato condicional para que se active cuando un número no sea igual al valor especificado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
number | Number | El único valor inaceptable. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenTextContains(text)
Configura la regla de formato condicional para que se active cuando la entrada contenga el valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Valor que debe contener la entrada. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenTextDoesNotContain(text)
Configura la regla de formato condicional para que se active cuando la entrada no contenga el valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Valor que no debe contener la entrada. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenTextEndsWith(text)
Configura la regla de formato condicional que se activa cuando la entrada finaliza con el valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Texto que se compara con el final de la cadena. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenTextEqualTo(text)
Configura la regla de formato condicional que se activará cuando la entrada sea igual al valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Es el único valor aceptable. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenTextStartsWith(text)
Configura la regla de formato condicional que se activa cuando la entrada comienza con el valor determinado.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
text | String | Texto que se compara con el principio de la cadena. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
withCriteria(criteria, args)
Configura la regla de formato condicional en los criterios definidos por los valores BooleanCriteria
, que por lo general se toman de criteria
y arguments
de una regla existente.
// 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);
Parámetros
Nombre | Tipo | Descripción |
---|---|---|
criteria | BooleanCriteria | Es el tipo de criterios de formato condicional. |
args | Object[] | Un array de argumentos apropiado para el tipo de criterio; la cantidad de argumentos y su tipo coinciden con el método when...() correspondiente anterior. |
Devolvedor
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.