Class ConditionalFormatRuleBuilder

ConditionalFormatRuleBuilder

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é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 reglas con la configuración de esta regla.
getBooleanCondition()BooleanConditionRecupera la información de BooleanCondition de la regla si esta usa criterios de condición booleana.
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 en 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 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)ConditionalFormatRuleBuilderBorra 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)ConditionalFormatRuleBuilderConfigura los campos de punto máximo de gradiente de la regla de formato condicional.
setGradientMaxpointWithValue(color, type, value)ConditionalFormatRuleBuilderConfigura los campos de punto máximo de gradiente de la regla de formato condicional.
setGradientMidpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderConfigura los campos de punto medio de gradiente de la regla de formato condicional.
setGradientMidpointWithValue(color, type, value)ConditionalFormatRuleBuilderConfigura los campos de punto medio de gradiente de la regla de formato condicional.
setGradientMinpoint(color)ConditionalFormatRuleBuilderBorra 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)ConditionalFormatRuleBuilderBorra 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)ConditionalFormatRuleBuilderConfigura los campos del punto mínimo de gradiente de la regla de formato condicional.
setGradientMinpointWithValue(color, type, value)ConditionalFormatRuleBuilderConfigura los campos del punto mínimo de gradiente de la regla de formato condicional.
setItalic(italic)ConditionalFormatRuleBuilderDefine la cursiva del texto en 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)ConditionalFormatRuleBuilderDefine tachado el texto para el formato de la regla de formato condicional.
setUnderline(underline)ConditionalFormatRuleBuilderDefine el subrayado del texto para el formato de la regla de formato condicional.
whenCellEmpty()ConditionalFormatRuleBuilderEstablece la regla de formato condicional que se debe activar cuando la celda está vacía.
whenCellNotEmpty()ConditionalFormatRuleBuilderEstablece la regla de formato condicional que se debe activar 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 especificado.
whenDateAfter(date)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando una fecha sea posterior a la fecha relativa especificada.
whenDateBefore(date)ConditionalFormatRuleBuilderConfigura 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)ConditionalFormatRuleBuilderConfigura 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)ConditionalFormatRuleBuilderEstablece la regla de formato condicional que se debe activar cuando la fórmula determinada se evalúa como true.
whenNumberBetween(start, end)ConditionalFormatRuleBuilderEstablece 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)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número sea igual a un valor determinado.
whenNumberGreaterThan(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número sea mayor que un valor determinado.
whenNumberGreaterThanOrEqualTo(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número sea mayor o igual que el especificado. valor.
whenNumberLessThan(number)ConditionalFormatRuleBuilderConfigura la regla de formato condicional para que se active cuando un número menor que el especificado. valor.
whenNumberLessThanOrEqualTo(number)ConditionalFormatRuleBuilderEstablece la regla de formato condicional para que se active cuando un número menor o igual que el especificado. valor.
whenNumberNotBetween(start, end)ConditionalFormatRuleBuilderEstablece 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)ConditionalFormatRuleBuilderEstablece la regla de formato condicional que se debe activar cuando un número no es igual al valor especificado.
whenTextContains(text)ConditionalFormatRuleBuilderEstablece la regla de formato condicional que se activará cuando la entrada contenga un valor determinado.
whenTextDoesNotContain(text)ConditionalFormatRuleBuilderEstablece la regla de formato condicional para que se active cuando la entrada no contenga el valor especificado. valor.
whenTextEndsWith(text)ConditionalFormatRuleBuilderEstablece la regla de formato condicional que se activará cuando la entrada finalice con el valor especificado.
whenTextEqualTo(text)ConditionalFormatRuleBuilderEstablece la regla de formato condicional que se activará cuando la entrada sea igual al valor determinado.
whenTextStartsWith(text)ConditionalFormatRuleBuilderEstablece la regla de formato condicional que se debe activar cuando la entrada comienza con el valor determinado.
withCriteria(criteria, args)ConditionalFormatRuleBuilderEstablece 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

NombreTipoDescripción
colorStringEl 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

NombreTipoDescripción
colorColorEl 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

NombreTipoDescripción
boldBooleanIndica 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

NombreTipoDescripción
colorStringEl 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

NombreTipoDescripción
colorColorEl 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

NombreTipoDescripción
colorStringEl 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

NombreTipoDescripción
colorColorEl 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

NombreTipoDescripción
colorColorEl color de punto máximo que se establecerá.
typeInterpolationTypeEl tipo de interpolación de punto máximo que se establecerá.
valueStringEl 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

NombreTipoDescripción
colorStringEl color de punto máximo que se establecerá.
typeInterpolationTypeEl tipo de interpolación de punto máximo que se establecerá.
valueStringEl 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

NombreTipoDescripción
colorColorEl color de punto medio que se establecerá.
typeInterpolationTypeEl tipo de interpolación de punto medio que se debe establecer o null para borrar.
valueStringEl 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

NombreTipoDescripción
colorStringEl color de punto medio que se establecerá.
typeInterpolationTypeEl tipo de interpolación de punto medio que se debe establecer o null para borrar.
valueStringEl 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

NombreTipoDescripción
colorStringEl 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

NombreTipoDescripción
colorColorEl 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

NombreTipoDescripción
colorColorEl color del punto mínimo que se establecerá.
typeInterpolationTypeEl tipo de interpolación de punto mínimo que se establecerá.
valueStringEl 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

NombreTipoDescripción
colorStringEl color del punto mínimo que se establecerá.
typeInterpolationTypeEl tipo de interpolación de punto mínimo que se establecerá.
valueStringEl 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

NombreTipoDescripción
italicBooleanIndica 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

NombreTipoDescripción
rangesRange[]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

NombreTipoDescripción
strikethroughBooleanIndica 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

NombreTipoDescripción
underlineBooleanSi 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

NombreTipoDescripción
dateDateLa 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

NombreTipoDescripción
dateRelativeDateLa 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

NombreTipoDescripción
dateDateLa 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

NombreTipoDescripción
dateRelativeDateLa 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

NombreTipoDescripción
dateDateLa ú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

NombreTipoDescripción
dateRelativeDateLa 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

NombreTipoDescripción
formulaStringEs 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

NombreTipoDescripción
startNumberEs el valor aceptable más bajo.
endNumberEs 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

NombreTipoDescripción
numberNumberEs 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

NombreTipoDescripción
numberNumberEs 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

NombreTipoDescripción
numberNumberEs 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

NombreTipoDescripción
numberNumberEs 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

NombreTipoDescripción
numberNumberEs 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

NombreTipoDescripción
startNumberEs el valor inaceptable más bajo.
endNumberEs 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

NombreTipoDescripción
numberNumberEl ú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

NombreTipoDescripción
textStringEs 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

NombreTipoDescripción
textStringEs 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

NombreTipoDescripción
textStringTexto 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

NombreTipoDescripción
textStringEs 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

NombreTipoDescripción
textStringTexto 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

NombreTipoDescripción
criteriaBooleanCriteriaEs el tipo de criterios de formato condicional.
argsObject[]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.