Dostęp do warunków logicznych w ConditionalFormatRules
. Każda reguła formatowania warunkowego może zawierać 1 warunek logiczny. Sam warunek logiczny zawiera kryteria logiczne (z wartościami) i ustawienia formatowania. Kryteria są oceniane na podstawie zawartości komórki, co daje wynik true
lub false
. Jeśli argument przyniesie wartość true
, do komórki zostaną zastosowane ustawienia formatowania warunku.
Metody
Metoda | Zwracany typ | Krótki opis |
---|---|---|
getBackgroundObject() | Color | Pobiera kolor tła dla tego warunku logicznego. |
getBold() | Boolean | Zwraca wartość true , jeśli ten warunek logiczny pogrubuje tekst i zwraca false , jeśli usunie on pogrubienie z tekstu. |
getCriteriaType() | BooleanCriteria | Pobiera typ kryterium reguły zgodnie z definicją w wyliczeniu BooleanCriteria . |
getCriteriaValues() | Object[] | Pobiera tablicę argumentów dla kryteriów reguły. |
getFontColorObject() | Color | Pobiera kolor czcionki dla tego warunku logicznego. |
getItalic() | Boolean | Zwraca wartość true , jeśli ten warunek logiczny pokazuje kursywę, a jeśli ten warunek logiczny usuwa kursywę z tekstu, zwraca wartość false . |
getStrikethrough() | Boolean | Zwraca wartość true , jeśli ten warunek logiczny zakończy się przekreśleniem, a jeśli ten warunek logiczny usunie przekreślenie, zwraca wartość false . |
getUnderline() | Boolean | Zwraca wartość true , jeśli ten warunek logiczny podkreśla tekst, a jeśli go usuwa, zwraca wartość false . |
Szczegółowa dokumentacja
getBackgroundObject()
Pobiera kolor tła dla tego warunku logicznego. Jeśli nie jest ustawiony, zwraca wartość null
.
// Logs the boolean condition background color for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var color = rules[i].getBooleanCondition().getBackgroundObject(); Logger.log("The background color for rule %s is %s", i, color.asRgbColor().asHexString()); }
Powroty
Color
– kolor tła lub null
, jeśli nie jest określony w tym warunku.
getBold()
Zwraca wartość true
, jeśli ten warunek logiczny pogrubuje tekst i zwraca false
, jeśli usunie on pogrubienie z tekstu. Zwraca wartość null
, jeśli pogrubienie nie zostało zmienione.
// Logs the boolean condition font weight for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var bold = rules[i].getBooleanCondition().getBold(); Logger.log("The font bold setting for rule %s is %b", i, weight); }
Powroty
Boolean
– określa, czy warunek logiczny ma pogrubić tekst, lub null
, jeśli pogrubienie nie ma wpływu na pogrubienie.
getCriteriaType()
Pobiera typ kryterium reguły zgodnie z definicją w wyliczeniu BooleanCriteria
. Aby uzyskać argumenty kryteriów, użyj getCriteriaValues()
. Aby użyć tych wartości do utworzenia lub zmiany reguły formatowania warunkowego, zobacz ConditionalFormatRuleBuilder.withCriteria(criteria, args)
.
// Log information about the conditional formats on the active sheet that use // boolean conditions. var sheet = SpreadsheetApp.getActiveSheet; var formats = sheet.getConditionalFormats(); sheet.getConditionalFormats().forEach(function(format) { var booleanCondition = format.getBooleanCondition(); if (booleanCondition) { var criteria = booleanCondition.getCriteriaType(); var args = booleanCondition.getCriteriaValues(); Logger.log('The conditional format rule is %s %s', criteria, args); } });
Powroty
BooleanCriteria
– typ kryteriów formatowania warunkowego,
getCriteriaValues()
Pobiera tablicę argumentów dla kryteriów reguły. Aby uzyskać typ kryterium, użyj getCriteriaType()
. Aby użyć tych wartości do utworzenia lub zmiany reguły formatowania warunkowego, zobacz ConditionalFormatRuleBuilder.withCriteria(criteria, args)
.
// Log information about the conditional formats on the active sheet that use // boolean conditions. var sheet = SpreadsheetApp.getActiveSheet; var formats = sheet.getConditionalFormats(); sheet.getConditionalFormats().forEach(function(format) { var booleanCondition = format.getBooleanCondition(); if (booleanCondition) { var criteria = booleanCondition.getCriteriaType(); var args = booleanCondition.getCriteriaValues(); Logger.log('The conditional format rule is %s %s', criteria, args); } });
Powroty
Object[]
– tablica argumentów odpowiednich do typu kryterium reguły; liczba argumentów i ich typ pasują do odpowiedniej metody when...()
klasy ConditionalFormatRuleBuilder
getFontColorObject()
Pobiera kolor czcionki dla tego warunku logicznego. Jeśli nie jest ustawiony, zwraca wartość null
.
// Logs the boolean condition font color for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var color = rules[i].getBooleanCondition().getFontColorObject(); Logger.log("The font color for rule %s is %s", i, color.asRgbColor().asHexString()); }
Powroty
Color
– kolor czcionki lub null
, jeśli nie jest określony w tym warunku.
getItalic()
Zwraca wartość true
, jeśli ten warunek logiczny pokazuje kursywę, a jeśli ten warunek logiczny usuwa kursywę z tekstu, zwraca wartość false
. Zwraca wartość null
, jeśli nie wprowadzono kursywy.
// Logs the boolean condition font style for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var italic = rules[i].getBooleanCondition().getItalic(); Logger.log("The font italic setting for rule %s is %b", i, italic); }
Powroty
Boolean
– określa, czy warunek logiczny powoduje kursywę tekstu, lub null
, jeśli kursywa nie ma wpływu.
getStrikethrough()
Zwraca wartość true
, jeśli ten warunek logiczny zakończy się przekreśleniem, a jeśli ten warunek logiczny usunie przekreślenie, zwraca wartość false
. Zwraca wartość null
, jeśli nie ma wpływu na przekreślenie.
// Logs the boolean condition strikethrough setting for each conditional format rule on a // sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var strikethrough = rules[i].getBooleanCondition().getStrikethrough(); Logger.log("The font strikethrough setting for rule %s is %b", i, strikethrough); }
Powroty
Boolean
– określa, czy warunek logiczny jest realizowany w całości, lub null
, jeśli nie ma wpływu na przekreślenie.
getUnderline()
Zwraca wartość true
, jeśli ten warunek logiczny podkreśla tekst, a jeśli go usuwa, zwraca wartość false
. Zwraca wartość null
, jeśli nie ma to wpływu na podkreślenie.
// Logs the boolean condition underline setting for each conditional format rule on a sheet. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var underline = rules[i].getBooleanCondition().getUnderline(); Logger.log("The font underline setting for rule %s is %b", i, underline); }
Powroty
Boolean
– określa, czy warunek logiczny podkreśla tekst, lub null
, jeśli podkreślenie nie ma wpływu na tekst.