Class BooleanCondition

BooleanCondition

Greifen Sie auf boolesche Bedingungen in ConditionalFormatRules zu. Jede Regel für die bedingte Formatierung kann eine einzelne boolesche Bedingung enthalten. Die boolesche Bedingung selbst enthält ein boolesches Kriterium (mit Werten) und Formatierungseinstellungen. Das Kriterium wird anhand des Inhalts einer Zelle ausgewertet, was entweder zu einem true- oder false-Wert führt. Wenn das Kriterium true ergibt, werden die Formatierungseinstellungen der Bedingung auf die Zelle angewendet.

Methoden

MethodeRückgabetypKurzbeschreibung
getBackgroundObject()ColorRuft die Hintergrundfarbe für diese boolesche Bedingung ab.
getBold()BooleanGibt true zurück, wenn mit dieser booleschen Bedingung der Text fett formatiert wird. Wenn durch diese boolesche Bedingung die Fettschrift im Text entfernt wird, wird false zurückgegeben.
getCriteriaType()BooleanCriteriaRuft den Kriterientyp der Regel entsprechend der Definition in BooleanCriteria-Enum ab.
getCriteriaValues()Object[]Ruft ein Array mit Argumenten für die Kriterien der Regel ab.
getFontColorObject()ColorRuft die Schriftfarbe für diese boolesche Bedingung ab.
getItalic()BooleanGibt true zurück, wenn mit dieser booleschen Bedingung der Text kursiv formatiert ist, und false, wenn durch diese boolesche Bedingung Kursivschrift aus dem Text entfernt wird.
getStrikethrough()BooleanGibt true zurück, wenn diese boolesche Bedingung den Text durchläuft. Gibt false zurück, wenn mit dieser booleschen Bedingung der Text nicht durchgestrichen wird.
getUnderline()BooleanGibt true zurück, wenn diese boolesche Bedingung den Text unterstreicht. Es wird false zurückgegeben, wenn durch diese boolesche Bedingung die Unterstreichung aus dem Text entfernt wird.

Detaillierte Dokumentation

getBackgroundObject()

Ruft die Hintergrundfarbe für diese boolesche Bedingung ab. Gibt null zurück, wenn nichts festgelegt ist.

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

Return

Color: Die Hintergrundfarbe oder null, wenn für diese Bedingung nicht festgelegt.


getBold()

Gibt true zurück, wenn mit dieser booleschen Bedingung der Text fett formatiert wird. Wenn durch diese boolesche Bedingung die Fettschrift im Text entfernt wird, wird false zurückgegeben. Gibt null zurück, wenn die Fettformatierung nicht betroffen ist.

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

Return

Boolean: Gibt an, ob mit der booleschen Bedingung der Text fett formatiert wird, oder null, wenn die Fettformatierung nicht betroffen ist


getCriteriaType()

Ruft den Kriterientyp der Regel entsprechend der Definition in BooleanCriteria-Enum ab. Verwenden Sie getCriteriaValues(), um die Argumente für die Kriterien abzurufen. Informationen dazu, wie Sie mit diesen Werten eine Regel für die bedingte Formatierung erstellen oder ändern, finden Sie unter 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);
  }
});

Return

BooleanCriteria: der Typ des Kriteriums für die bedingte Formatierung


getCriteriaValues()

Ruft ein Array mit Argumenten für die Kriterien der Regel ab. Verwenden Sie getCriteriaType(), um den Kriterientyp abzurufen. Informationen zum Erstellen oder Ändern einer Regel für die bedingte Formatierung mit diesen Werten finden Sie unter 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);
  }
});

Return

Object[]: Ein Array mit Argumenten entsprechend dem Kriterientyp der Regel. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden when...()-Methode der ConditionalFormatRuleBuilder-Klasse überein.


getFontColorObject()

Ruft die Schriftfarbe für diese boolesche Bedingung ab. Gibt null zurück, wenn nichts festgelegt ist.

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

Return

Color: Die Schriftfarbe oder null, wenn für diese Bedingung nicht festgelegt.


getItalic()

Gibt true zurück, wenn mit dieser booleschen Bedingung der Text kursiv formatiert ist, und false, wenn durch diese boolesche Bedingung Kursivschrift aus dem Text entfernt wird. Gibt null zurück, wenn keine Kursivschrift verwendet wird.

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

Return

Boolean: Gibt an, ob mit der booleschen Bedingung der Text kursiv dargestellt wird, oder null, wenn die Kursivschrift nicht betroffen ist


getStrikethrough()

Gibt true zurück, wenn diese boolesche Bedingung den Text durchläuft. Gibt false zurück, wenn mit dieser booleschen Bedingung der Text nicht durchgestrichen wird. Gibt null zurück, wenn das Durchstreichen nicht betroffen ist.

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

Return

Boolean: Gibt an, ob die boolesche Bedingung durch den Text ausgelöst wird, oder null, wenn das Durchstreichen nicht betroffen ist


getUnderline()

Gibt true zurück, wenn diese boolesche Bedingung den Text unterstreicht. Es wird false zurückgegeben, wenn durch diese boolesche Bedingung die Unterstreichung aus dem Text entfernt wird. Gibt null zurück, wenn das Unterstreichen nicht betroffen ist.

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

Return

Boolean: Gibt an, ob die boolesche Bedingung den Text unterstreicht oder null, wenn die Unterstreichung nicht betroffen ist

Verworfene Methoden