Class ConditionalFormatRule

ConditionalFormatRule

Accedere alle regole di formattazione condizionale. Per creare una nuova regola, utilizza SpreadsheetApp.newConditionalFormatRule() e ConditionalFormatRuleBuilder. Puoi utilizzare Sheet.setConditionalFormatRules(rules) per impostare regole personalizzate per un determinato foglio.

Metodi

MetodoTipo restituitoBreve descrizione
copy()ConditionalFormatRuleBuilderRestituisce un preset del generatore di regole con le impostazioni di questa regola.
getBooleanCondition()BooleanConditionRecupera le informazioni BooleanCondition della regola se questa regola utilizza i criteri di condizione booleani.
getGradientCondition()GradientConditionRecupera le informazioni GradientCondition della regola, se questa regola utilizza criteri delle condizioni del gradiente.
getRanges()Range[]Recupera gli intervalli a cui viene applicata questa regola di formattazione condizionale.

Documentazione dettagliata

copy()

Restituisce un preset del generatore di regole con le impostazioni di questa regola.

Invio

ConditionalFormatRuleBuilder: uno strumento per la creazione basato sulle impostazioni di questa regola

getBooleanCondition()

Recupera le informazioni BooleanCondition della regola se questa regola utilizza i criteri di condizione booleani. In caso contrario, restituisce 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());
}

Invio

BooleanCondition: l'oggetto condizione booleano o null se la regola non utilizza un valore booleano .

getGradientCondition()

Recupera le informazioni GradientCondition della regola, se questa regola utilizza criteri delle condizioni del gradiente. In caso contrario, restituisce 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());
}

Invio

GradientCondition: l'oggetto condizione gradiente o null se la regola non utilizza un gradiente. .

getRanges()

Recupera gli intervalli a cui viene applicata questa regola di formattazione condizionale. 

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

Invio

Range[]: gli intervalli a cui viene applicata questa regola di formattazione condizionale.