Class ConditionalFormatRule

ConditionalFormatRule

Dostęp do reguł formatowania warunkowego. Aby utworzyć nową regułę, użyj elementów SpreadsheetApp.newConditionalFormatRule() i ConditionalFormatRuleBuilder. Za pomocą Sheet.setConditionalFormatRules(rules) możesz określić dla konkretnego arkusza.

Metody

MetodaZwracany typKrótki opis
copy()ConditionalFormatRuleBuilderZwraca gotowe konstruktor reguł z ustawieniami tej reguły.
getBooleanCondition()BooleanConditionPobiera informacje o regule BooleanCondition, jeśli ta reguła korzysta z: kryterium warunku logicznego.
getGradientCondition()GradientConditionPobiera informacje o regule GradientCondition, jeśli ta reguła korzysta z kryteriów warunku gradientu.
getRanges()Range[]Pobiera zakresy, do których stosowana jest ta reguła formatowania warunkowego.

Szczegółowa dokumentacja

copy()

Zwraca gotowe konstruktor reguł z ustawieniami tej reguły.

Powrót

ConditionalFormatRuleBuilder – kreator oparty na ustawieniach tej reguły

getBooleanCondition()

Pobiera informacje o regule BooleanCondition, jeśli ta reguła korzysta z: kryterium warunku logicznego. W przeciwnym razie zwraca wartość 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());
}

Powrót

BooleanCondition – obiekt warunku logicznego lub null, jeśli reguła nie korzysta z wartości logicznej; .

getGradientCondition()

Pobiera informacje o regule GradientCondition, jeśli ta reguła korzysta z kryteriów warunku gradientu. W przeciwnym razie zwraca wartość 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());
}

Powrót

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

getRanges()

Pobiera zakresy, do których stosowana jest ta reguła formatowania warunkowego. 

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

Powrót

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