Class ConditionalFormatRule

Regułaformatowaniawarunkowego

Dostęp do reguł formatowania warunkowego. Aby utworzyć nową regułę, użyj SpreadsheetApp.newConditionalFormatRule() i ConditionalFormatRuleBuilder. Za pomocą Sheet.setConditionalFormatRules(rules) możesz ustawić reguły dla danego arkusza.

Metody

MetodaZwracany typKrótki opis
copy()ConditionalFormatRuleBuilderZwraca gotowe ustawienia narzędzia do tworzenia reguł z ustawieniami tej reguły.
getBooleanCondition()BooleanConditionPobiera informacje o BooleanCondition reguły, jeśli używa ona kryteriów warunku logicznego.
getGradientCondition()GradientConditionPobiera informacje GradientCondition o regule, jeśli używa ona kryteriów warunku gradientu.
getRanges()Range[]Pobiera zakresy, do których ma zastosowanie ta reguła formatowania warunkowego.

Szczegółowa dokumentacja

copy()

Zwraca gotowe ustawienia narzędzia do tworzenia reguł z ustawieniami tej reguły.

Powrót

ConditionalFormatRuleBuilder – narzędzie do tworzenia na podstawie ustawień tej reguły.

getBooleanCondition()

Pobiera informacje o BooleanCondition reguły, jeśli używa ona kryteriów warunku logicznego. W przeciwnym razie zwraca wartość null. 

// Log the boolean criteria type of the first conditional format rules of a // sheet. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const booleanCondition = rule.getBooleanCondition(); if (booleanCondition != null) {   Logger.log(booleanCondition.getCriteriaType()); }

Powrót

BooleanCondition – obiekt warunku logicznego lub null, jeśli reguła nie używa warunku logicznego.

getGradientCondition()

Pobiera informacje GradientCondition o regule, jeśli używa ona kryteriów warunku gradientu. W przeciwnym razie zwraca wartość null. 

// Log the gradient minimum color of the first conditional format rule of a // sheet. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const gradientCondition = rule.getGradientCondition(); if (gradientCondition != null) {   // Assume the color has ColorType.RGB.   Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString()); }

Powrót

GradientCondition – obiekt warunku gradientu lub null, jeśli reguła nie używa warunku gradientu.

getRanges()

Pobiera zakresy, do których ma zastosowanie ta reguła formatowania warunkowego. 

// Log each range of the first conditional format rule of a sheet. const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; const ranges = rule.getRanges(); for (let i = 0; i < ranges.length; i++) {   Logger.log(ranges[i].getA1Notation()); }

Powrót

Range[] – zakresy, do których stosowana jest ta reguła formatowania warunkowego.