Dostęp do reguł formatowania warunkowego. Aby utworzyć nową regułę, użyj SpreadsheetApp.newConditionalFormatRule() i ConditionalFormatRuleBuilder.
Reguły dla danego arkusza możesz ustawić za pomocą polecenia Sheet.setConditionalFormatRules(rules).
Metody
| Metoda | Zwracany typ | Krótki opis |
|---|---|---|
copy() | ConditionalFormatRuleBuilder | Zwraca gotowe ustawienia konstruktora reguł z ustawieniami tej reguły. |
getBooleanCondition() | BooleanCondition | Pobiera informacje o BooleanCondition reguły, jeśli ta reguła używa logicznych kryteriów warunku. |
getGradientCondition() | GradientCondition | Pobiera informacje o GradientCondition reguły, jeśli ta reguła używa kryteriów warunku gradientu. |
getRanges() | Range[] | Pobiera zakresy, do których zastosowano tę regułę formatowania warunkowego. |
Szczegółowa dokumentacja
copy()
Zwraca gotowe ustawienia konstruktora reguł z ustawieniami tej reguły.
Powroty
ConditionalFormatRuleBuilder – kreator oparty na ustawieniach tej reguły,
getBooleanCondition()
Pobiera informacje o BooleanCondition reguły, jeśli ta reguła używa logicznych kryteriów warunku. 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());
}
Powroty
BooleanCondition – obiekt warunku logicznego, lub null, jeśli reguła nie używa warunku logicznego.
getGradientCondition()
Pobiera informacje o GradientCondition reguły, jeśli ta reguła używa 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());
}
Powroty
GradientCondition – obiekt warunku gradientu lub null, jeśli reguła nie używa warunku gradientu.
getRanges()
Pobiera zakresy, do których zastosowano tę regułę 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());
}
Powroty
Range[] – zakresy, do których stosowana jest reguła formatowania warunkowego;