Class BooleanCondition

BooleanCondition

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

MetodaZwracany typKrótki opis
getBackgroundObject()ColorPobiera kolor tła dla tego warunku logicznego.
getBold()BooleanZwraca wartość true, jeśli ten warunek logiczny pogrubuje tekst i zwraca false, jeśli usunie on pogrubienie z tekstu.
getCriteriaType()BooleanCriteriaPobiera typ kryterium reguły zgodnie z definicją w wyliczeniu BooleanCriteria.
getCriteriaValues()Object[]Pobiera tablicę argumentów dla kryteriów reguły.
getFontColorObject()ColorPobiera kolor czcionki dla tego warunku logicznego.
getItalic()BooleanZwraca wartość true, jeśli ten warunek logiczny pokazuje kursywę, a jeśli ten warunek logiczny usuwa kursywę z tekstu, zwraca wartość false.
getStrikethrough()BooleanZwraca 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()BooleanZwraca 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.

Wycofane metody