Es un 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 | Crea 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 de BooleanCondition de la regla si esta usa
criterios de condición booleana. |
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 en 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 en 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 en los rangos de la regla. |
setGradientMaxpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Configura los campos de punto máximo de gradiente de la regla de formato condicional. |
setGradientMaxpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Configura 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 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 en los rangos de la regla. |
setGradientMinpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | Configura los campos del punto mínimo de gradiente de la regla de formato condicional. |
setGradientMinpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | Configura los campos del punto mínimo de gradiente de la regla de formato condicional. |
setItalic(italic) | ConditionalFormatRuleBuilder | Define la cursiva del texto en 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 | Define tachado el texto para el formato de la regla de formato condicional. |
setUnderline(underline) | ConditionalFormatRuleBuilder | Define el subrayado del texto para el formato de la regla de formato condicional. |
whenCellEmpty() | ConditionalFormatRuleBuilder | Establece la regla de formato condicional que se debe activar cuando la celda está vacía. |
whenCellNotEmpty() | ConditionalFormatRuleBuilder | Establece la regla de formato condicional que se debe 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 especificado. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando una fecha sea posterior a la fecha relativa especificada. |
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 especificada. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha especificada. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha relativa especificada. |
whenFormulaSatisfied(formula) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional que se debe activar cuando la fórmula determinada se evalúa como true . |
whenNumberBetween(start, end) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional que se activará cuando un número se encuentre entre dos o sea uno de dos. valores especificados. |
whenNumberEqualTo(number) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando un número sea igual a un valor determinado. |
whenNumberGreaterThan(number) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando un número sea mayor que un valor determinado. |
whenNumberGreaterThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando un número sea mayor o igual que el especificado. valor. |
whenNumberLessThan(number) | ConditionalFormatRuleBuilder | Configura la regla de formato condicional para que se active cuando un número menor que el especificado. valor. |
whenNumberLessThanOrEqualTo(number) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional para que se active cuando un número menor o igual que el especificado. valor. |
whenNumberNotBetween(start, end) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional para que se active cuando un número no se encuentre en medio o no sea igual. de dos valores especificados. |
whenNumberNotEqualTo(number) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional que se debe activar cuando un número no es igual al valor especificado. |
whenTextContains(text) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional que se activará cuando la entrada contenga un valor determinado. |
whenTextDoesNotContain(text) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional para que se active cuando la entrada no contenga el valor especificado. valor. |
whenTextEndsWith(text) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional que se activará cuando la entrada finalice con el valor especificado. |
whenTextEqualTo(text) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional que se activará cuando la entrada sea igual al valor determinado. |
whenTextStartsWith(text) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional que se debe activar cuando la entrada comienza con el valor determinado. |
withCriteria(criteria, args) | ConditionalFormatRuleBuilder | Establece la regla de formato condicional en los criterios definidos por los valores de BooleanCriteria .
generalmente se toman de la criteria y la arguments de un
regla existente. |
Documentación detallada
build()
Crea una regla de formato condicional a partir de la configuración aplicada al compilador.
Volver
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.
Volver
ConditionalFormatRuleBuilder
: Es un compilador basado en la configuración de esta regla.
getBooleanCondition()
Recupera la información de BooleanCondition
de la regla si esta usa
criterios de condición booleana. 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()); }
Volver
BooleanCondition
: Es el objeto de condición booleana, o null
si la regla no usa un valor booleano.
estado.
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()); }
Volver
GradientCondition
: Es el objeto de condición de gradiente, o null
si la regla no usa un gradiente.
estado.
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()); }
Volver
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. Pasando en null
quita de la regla la configuración de formato de color de fondo.
// 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 que quieres o null para borrar. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setBackgroundObject(color)
Establece el color de fondo para el formato de la regla de formato condicional. Pasando en null
quita de la regla la configuración de formato de color de fondo.
// 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. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador, para el encadenamiento.
setBold(bold)
Establece la negrita del texto en el formato de la regla de formato condicional. Si bold
es true
,
la regla en negritas si la condición se cumple; si es false
, la regla quita todos
negrita si se cumple la condición. Al pasar null
, se 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. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setFontColor(color)
Establece el color de fuente para el formato de la regla de formato condicional. Si pasas null
, se quitará
la configuración de formato de color de 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 que quieres o null para borrar. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setFontColorObject(color)
Establece el color de fuente para el formato de la regla de formato condicional. Si pasas null
, se quitará
la configuración de formato de color de 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. |
Volver
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 en los rangos de la regla. También establece el color del 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á. |
Volver
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 en los rangos de la regla. También establece el color del 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 maxpoint que se configurará. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador, para el encadenamiento.
setGradientMaxpointObjectWithValue(color, type, value)
Configura 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á. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador, para el encadenamiento.
setGradientMaxpointWithValue(color, type, value)
Configura 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á. |
Volver
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 | El color de punto medio que se establecerá. |
type | InterpolationType | El tipo de interpolación de punto medio que se debe establecer o null para borrar. |
value | String | El valor de punto medio que se debe establecer. |
Volver
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 | El color de punto medio que se establecerá. |
type | InterpolationType | El tipo de interpolación de punto medio que se debe establecer o null para borrar. |
value | String | El valor de punto medio que se debe establecer. |
Volver
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 en los rangos de la regla. También establece el color del 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 | El color del punto mínimo que se establecerá. |
Volver
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 en los rangos de la regla. También establece el color del 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á. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador, para el encadenamiento.
setGradientMinpointObjectWithValue(color, type, value)
Configura los campos del 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 | El color del punto mínimo que se establecerá. |
type | InterpolationType | El tipo de interpolación de punto mínimo que se establecerá. |
value | String | El valor de punto mínimo que se establecerá. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador, para el encadenamiento.
setGradientMinpointWithValue(color, type, value)
Configura los campos del 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 | El color del punto mínimo que se establecerá. |
type | InterpolationType | El tipo de interpolación de punto mínimo que se establecerá. |
value | String | El valor de punto mínimo que se establecerá. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setItalic(italic)
Establece la cursiva del texto en el formato de la regla de formato condicional. Si italic
es true
,
la regla escribe en cursiva el texto si se cumple la condición; si es false
, la regla quita
la cursiva existente si se cumple la condición. Si pasas null
, se quita la cursiva.
de formato 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. |
Volver
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. Si configuras un array vacío, se borrarán los rangos existentes. Una regla debe tengan 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. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setStrikethrough(strikethrough)
Define tachado 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. Pasando en null
quita de la regla el parámetro de configuración del formato tachado.
// 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 estar tachado o no si la condición de formato es
met; null quita esta configuración. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
setUnderline(underline)
Define el subrayado del 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
subrayados existentes si se cumple la condición. Cuando pasas null
, se quita el subrayado.
de formato 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 | Si el texto debe estar subrayado o no si se cumple la condición de formato
null quita esta configuración. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenCellEmpty()
Establece la regla de formato condicional que se debe 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);
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenCellNotEmpty()
Establece la regla de formato condicional que se debe 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);
Volver
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 especificado.
// 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. |
Volver
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 especificada.
// 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. |
Volver
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 antigua inaceptable |
Volver
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 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 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. |
Volver
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 especificada.
// 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 |
Volver
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 especificada.
// 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. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenFormulaSatisfied(formula)
Establece la regla de formato condicional que se debe activar cuando la fórmula determinada se evalúa 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 | Es una fórmula personalizada que se evalúa como true si la entrada es válida. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberBetween(start, end)
Establece la regla de formato condicional para que se active cuando un número se encuentre entre dos o uno de 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 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 | Es el valor aceptable más bajo. |
end | Number | Es el valor aceptable más alto. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberEqualTo(number)
Configura la regla de formato condicional para que se active cuando un número sea igual a un 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. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberGreaterThan(number)
Configura la regla de formato condicional para que se active cuando un número sea mayor que un 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 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. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberGreaterThanOrEqualTo(number)
Configura la regla de formato condicional para que se active cuando un número sea mayor o igual que el especificado. valor.
// 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 | Es el valor aceptable más bajo. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberLessThan(number)
Configura la regla de formato condicional para que se active cuando un número menor que el especificado. valor.
// 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 | Es el valor inaceptable más bajo. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberLessThanOrEqualTo(number)
Establece la regla de formato condicional para que se active cuando un número menor o igual que el especificado. valor.
// 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. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberNotBetween(start, end)
Establece la regla de formato condicional para que se active cuando un número no se encuentre en medio o no sea igual. de 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 | Es el valor inaceptable más bajo. |
end | Number | Es el valor inaceptable más alto. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenNumberNotEqualTo(number)
Establece la regla de formato condicional que se debe activar cuando un número no es 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. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenTextContains(text)
Establece la regla de formato condicional que se activará cuando la entrada contenga un 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 | Es el valor que debe contener la entrada. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenTextDoesNotContain(text)
Establece la regla de formato condicional para que se active cuando la entrada no contenga el valor especificado. valor.
// 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 | Es el valor que no debe contener la entrada. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenTextEndsWith(text)
Establece la regla de formato condicional que se activará cuando la entrada finalice con el valor especificado.
// 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 para comparar con el final de la cadena |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenTextEqualTo(text)
Establece 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. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
whenTextStartsWith(text)
Establece la regla de formato condicional que se debe activar 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 para comparar con el principio de la cadena |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.
withCriteria(criteria, args)
Establece la regla de formato condicional en los criterios definidos por los valores de BooleanCriteria
.
generalmente se toma de la criteria
y la arguments
de un
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 apropiados para el tipo de criterios. la cantidad de argumentos y
su tipo coincide con el método when...() correspondiente anterior. |
Volver
ConditionalFormatRuleBuilder
: Es el compilador para el encadenamiento.