Class ConditionalFormatRuleBuilder

Organiza tus páginas con colecciones Guarda y categoriza el contenido según tus preferencias.
ConditionalFormatRuleBuilder.

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étodoTipo de datos que se muestraDescripción breve
build()ConditionalFormatRuleCrea una regla de formato condicional a partir de la configuración aplicada al compilador.
copy()ConditionalFormatRuleBuilderMuestra un ajuste predeterminado del creador de normas con la configuración de esta regla.
getBooleanCondition()BooleanConditionRecupera la información BooleanCondition de la regla si esta regla usa criterios de condición booleanos.
getGradientCondition()GradientConditionRecupera 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)ConditionalFormatRuleBuilderEstablece el color de fondo para el formato de la regla de formato condicional.
setBackgroundObject(color)ConditionalFormatRuleBuilderEstablece el color de fondo para el formato de la regla de formato condicional.
setBold(bold)ConditionalFormatRuleBuilderEstablece la negrita del texto para el formato de la regla de formato condicional.
setFontColor(color)ConditionalFormatRuleBuilderEstablece el color de fuente para el formato de la regla de formato condicional.
setFontColorObject(color)ConditionalFormatRuleBuilderEstablece el color de fuente para el formato de la regla de formato condicional.
setGradientMaxpoint(color)ConditionalFormatRuleBuilderBorra el valor máximo de punto de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo en los rangos de la regla.
setGradientMaxpointObject(color)ConditionalFormatRuleBuilderBorra el valor máximo de punto de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo en los rangos de la regla.
setGradientMaxpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderEstablece los campos de punto máximo de gradiente de la regla de formato condicional.
setGradientMaxpointWithValue(color, type, value)ConditionalFormatRuleBuilderEstablece los campos de punto máximo de gradiente de la regla de formato condicional.
setGradientMidpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderEstablece los campos de punto medio de gradiente de formato condicional.
setGradientMidpointWithValue(color, type, value)ConditionalFormatRuleBuilderEstablece los campos de punto medio de gradiente de formato condicional.
setGradientMinpoint(color)ConditionalFormatRuleBuilderBorra el valor de punto de gradiente de la regla de formato condicional y, en su lugar, usa el valor mínimo en los rangos de la regla.
setGradientMinpointObject(color)ConditionalFormatRuleBuilderBorra el valor de punto de 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)ConditionalFormatRuleBuilderEstablece los campos de punto de gradiente de la regla de formato condicional.
setGradientMinpointWithValue(color, type, value)ConditionalFormatRuleBuilderEstablece los campos de punto de gradiente de la regla de formato condicional.
setItalic(italic)ConditionalFormatRuleBuilderEstablece cursiva de texto para el formato de la regla de formato condicional.
setRanges(ranges)ConditionalFormatRuleBuilderEstablece uno o más rangos a los que se aplica esta regla de formato condicional.
setStrikethrough(strikethrough)ConditionalFormatRuleBuilderEstablece el texto tachado para el formato de la regla de formato condicional.
setUnderline(underline)ConditionalFormatRuleBuilderEstablece el subrayado de texto para el formato de la regla de formato condicional.
whenCellEmpty()ConditionalFormatRuleBuilderEstablece la regla de formato condicional para que se active cuando la celda esté vacía.
whenCellNotEmpty()ConditionalFormatRuleBuilderEstablece la regla de formato condicional para que se active cuando la celda no esté vacía.
whenDateAfter(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea posterior al valor determinado.
whenDateAfter(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea posterior a la fecha relativa especificada.
whenDateBefore(date)ConditionalFormatRuleBuilderEstablece la regla de formato condicional para que se active cuando una fecha sea anterior a la fecha especificada.
whenDateBefore(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea anterior a la fecha relativa especificada.
whenDateEqualTo(date)ConditionalFormatRuleBuilderEstablece la regla de formato condicional para que se active cuando una fecha sea igual a la fecha especificada.
whenDateEqualTo(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea igual a la fecha relativa especificada.
whenFormulaSatisfied(formula)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando la fórmula especificada se evalúe como true.
whenNumberBetween(start, end)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número se encuentre entre uno de los dos valores especificados o cuando esté en uno de ellos.
whenNumberEqualTo(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número sea igual al valor especificado.
whenNumberGreaterThan(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número sea mayor que el valor especificado.
whenNumberGreaterThanOrEqualTo(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número sea mayor o igual que el valor determinado.
whenNumberLessThan(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional condicional para que se active cuando un número sea menor que el valor determinado.
whenNumberLessThanOrEqualTo(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número sea menor o igual que el valor determinado.
whenNumberNotBetween(start, end)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número no se encuentre entre dos valores especificados.
whenNumberNotEqualTo(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número no sea igual al valor especificado.
whenTextContains(text)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando la entrada contenga el valor dado.
whenTextDoesNotContain(text)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando la entrada no contenga el valor determinado.
whenTextEndsWith(text)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando esa entrada finalice con un valor determinado.
whenTextEqualTo(text)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando la entrada sea igual al valor dado.
whenTextStartsWith(text)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando la entrada comience con el valor determinado.
withCriteria(criteria, args)ConditionalFormatRuleBuilderEstablece la regla de formato condicional en criterios definidos por valores BooleanCriteria, que por lo general se toman de criteria y arguments de una 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 normas 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 BooleanCondition de la regla si esta regla usa criterios de condición booleanos. 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 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());
}

Volver

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());
}

Volver

Range[]: 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

NombreTipoDescripción
colorStringEl color deseado o null para borrar.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


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

NombreTipoDescripción
colorColorEl objeto de color deseado o null para borrar.

Volver

ConditionalFormatRuleBuilder: el compilador para la cadena.


setBold(bold)

Establece la negrita del texto para el formato de la regla de formato condicional. Si bold es true, la regla muestra texto en negrita si se cumple la condición; si es false, la regla quita cualquier negrita existente si se cumple. 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

NombreTipoDescripción
boldBooleanEstablece si el texto debe estar en negrita si se cumple la condición de formato; null quita esta configuración.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


setFontColor(color)

Establece el color de fuente para el formato de la regla de formato condicional. Si pasas null, se quita de la regla la configuración de formato del color de la fuente.

// 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

NombreTipoDescripción
colorStringEl color deseado o null para borrar.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


setFontColorObject(color)

Establece el color de fuente para el formato de la regla de formato condicional. Si pasas null, se quita de la regla la configuración de formato del color de la fuente.

// 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

NombreTipoDescripción
colorColorEl objeto de color deseado o null para borrar.

Volver

ConditionalFormatRuleBuilder: el compilador para la cadena.


setGradientMaxpoint(color)

Borra el valor máximo de punto de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo en 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

NombreTipoDescripción
colorStringEl color de punto máximo que se establecerá.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


setGradientMaxpointObject(color)

Borra el valor máximo de punto de gradiente de la regla de formato condicional y, en su lugar, usa el valor máximo en 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

NombreTipoDescripción
colorColorEl objeto de color de punto máximo que se configurará.

Volver

ConditionalFormatRuleBuilder: el compilador para la cadena.


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

NombreTipoDescripción
colorColorEl color de punto máximo que se establecerá.
typeInterpolationTypeEl tipo de interpolación de punto máximo que se debe establecer.
valueStringEl valor de punto máximo que se configurará.

Volver

ConditionalFormatRuleBuilder: el compilador para la cadena.


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

NombreTipoDescripción
colorStringEl color de punto máximo que se establecerá.
typeInterpolationTypeEl tipo de interpolación de punto máximo que se debe establecer.
valueStringEl valor de punto máximo que se configurará.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


setGradientMidpointObjectWithValue(color, type, value)

Establece los campos de punto medio de gradiente 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

NombreTipoDescripción
colorColorEl color de punto medio que se debe establecer.
typeInterpolationTypeEl tipo de interpolación de puntos medios que se va a establecer o null para borrar
valueStringEl valor de punto medio que se debe establecer.

Volver

ConditionalFormatRuleBuilder: el compilador para la cadena.


setGradientMidpointWithValue(color, type, value)

Establece los campos de punto medio de gradiente 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

NombreTipoDescripción
colorStringEl color de punto medio que se debe establecer.
typeInterpolationTypeEl tipo de interpolación de puntos medios que se va a establecer o null para borrar
valueStringEl valor de punto medio que se debe establecer.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


setGradientMinpoint(color)

Borra el valor de punto de 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 de 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

NombreTipoDescripción
colorStringEl color de punto mínimo que se establecerá.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


setGradientMinpointObject(color)

Borra el valor de punto de 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 de 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

NombreTipoDescripción
colorColorEl objeto de color de punto mínimo que se configurará.

Volver

ConditionalFormatRuleBuilder: el compilador para la cadena.


setGradientMinpointObjectWithValue(color, type, value)

Establece los campos de punto 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

NombreTipoDescripción
colorColorEl color de punto mínimo que se establecerá.
typeInterpolationTypeEl tipo de interpolación de puntos mínimos que se va a configurar
valueStringEl valor de punto mínimo para establecer.

Volver

ConditionalFormatRuleBuilder: el compilador para la cadena.


setGradientMinpointWithValue(color, type, value)

Establece los campos de punto 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

NombreTipoDescripción
colorStringEl color de punto mínimo que se establecerá.
typeInterpolationTypeEl tipo de interpolación de puntos mínimos que se va a configurar
valueStringEl valor de punto mínimo para establecer.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


setItalic(italic)

Establece cursiva de texto para el formato de la regla de formato condicional. Si italic es true, la regla cursa el texto 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 en 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

NombreTipoDescripción
italicBooleanSi el texto debe o no estar en cursiva si se cumple la condición de formato; null quita esta configuración.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


setRanges(ranges)

Establece uno o más rangos a los que se aplica esta regla de formato condicional. Esta operación reemplaza los rangos existentes. Si estableces un arreglo vacío, se borrarán 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

NombreTipoDescripción
rangesRange[]Los rangos a los que se aplica esta regla de formato condicional.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


setStrikethrough(strikethrough)

Establece el texto tachado 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. Si pasas null, se 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

NombreTipoDescripción
strikethroughBooleanSi el texto se debe tachar o no si se cumple la condición de formato; null quita esta configuración.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


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. Si pasas null, se 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

NombreTipoDescripción
underlineBooleanEstablece si el texto debe estar subrayado o no si se cumple la condición de formato. null quita esta configuración.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenCellEmpty()

Establece la regla de formato condicional para que se active 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: el compilador para encadenar


whenCellNotEmpty()

Establece la regla de formato condicional para que se active 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: el compilador para encadenar


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

NombreTipoDescripción
dateDateLa fecha más reciente.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


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

NombreTipoDescripción
dateRelativeDateLa fecha más reciente relacionada con el tipo de fecha seleccionado.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenDateBefore(date)

Establece 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

NombreTipoDescripción
dateDateLa fecha inadmisible más antigua

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


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

NombreTipoDescripción
dateRelativeDateLa fecha más reciente relacionada con el tipo de fecha seleccionado.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenDateEqualTo(date)

Establece 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

NombreTipoDescripción
dateDateLa única fecha aceptable.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


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

NombreTipoDescripción
dateRelativeDateLa fecha más reciente relacionada con el tipo de fecha seleccionado.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenFormulaSatisfied(formula)

Configura la regla de formato condicional para que se active cuando la fórmula especificada 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

NombreTipoDescripción
formulaStringUna fórmula personalizada que se evalúa como true si la entrada es válida.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenNumberBetween(start, end)

Configura la regla de formato condicional para que se active cuando un número se encuentre entre uno de los dos valores especificados o cuando esté en uno 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

NombreTipoDescripción
startNumberEs el valor aceptable más bajo.
endNumberEs el valor aceptable más alto.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenNumberEqualTo(number)

Configura la regla de formato condicional para que se active cuando un número 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 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

NombreTipoDescripción
numberNumberEs el único valor aceptable.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenNumberGreaterThan(number)

Configura la regla de formato condicional para que se active cuando un número sea 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

NombreTipoDescripción
numberNumberEs el valor inaceptable más alto.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenNumberGreaterThanOrEqualTo(number)

Configura la regla de formato condicional para que se active cuando un número sea 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

NombreTipoDescripción
numberNumberEs el valor aceptable más bajo.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenNumberLessThan(number)

Configura la regla de formato condicional condicional para que se active cuando un número sea menor 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 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

NombreTipoDescripción
numberNumberEs el valor más bajo inaceptable.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenNumberLessThanOrEqualTo(number)

Configura la regla de formato condicional para que se active cuando un número sea 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

NombreTipoDescripción
numberNumberEs el valor aceptable más alto.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenNumberNotBetween(start, end)

Configura la regla de formato condicional para que se active cuando un número no se encuentre entre 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

NombreTipoDescripción
startNumberEs el valor más bajo inaceptable.
endNumberEs el valor inaceptable más alto.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


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

NombreTipoDescripción
numberNumberEl único valor inaceptable.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenTextContains(text)

Configura la regla de formato condicional para que se active cuando la entrada contenga el valor dado.

// 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

NombreTipoDescripción
textStringEl valor que debe contener la entrada.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


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

NombreTipoDescripción
textStringValor que no debe contener la entrada.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenTextEndsWith(text)

Configura la regla de formato condicional para que se active cuando esa entrada finalice con un 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

NombreTipoDescripción
textStringTexto para comparar con el final de la string

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenTextEqualTo(text)

Configura la regla de formato condicional para que se active cuando la entrada sea igual al valor dado.

// 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

NombreTipoDescripción
textStringEs el único valor aceptable.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


whenTextStartsWith(text)

Configura la regla de formato condicional para que se active cuando la entrada comience 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

NombreTipoDescripción
textStringTexto para comparar con el principio de la string

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar


withCriteria(criteria, args)

Establece la regla de formato condicional en criterios definidos por 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

NombreTipoDescripción
criteriaBooleanCriteriaEl tipo de criterios de formato condicional.
argsObject[]Un arreglo de argumentos adecuados para el tipo de criterios; la cantidad de argumentos y su tipo coinciden con el método when...() correspondiente anterior.

Volver

ConditionalFormatRuleBuilder: el compilador para encadenar