Class BooleanCondition

Boolesche Bedingung

Greifen Sie in ConditionalFormatRules auf boolesche Bedingungen zu. Jede bedingte Formatregel kann eine einzelne boolesche Bedingung enthalten. Die boolesche Bedingung selbst enthält boolesche Kriterien (mit Werten) und Formatierungseinstellungen. Das Kriterium wird anhand des Zelleninhalts ausgewertet, was zu einem true- oder false-Wert führt. Wenn das Kriterium als true ausgewertet wird, 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 diese boolesche Bedingung den Text fett formatiert, und false, wenn diese boolesche Bedingung den Text fett formatiert.
getCriteriaType()BooleanCriteriaRuft den Kriterientyp der Regel wie in der Aufzählung BooleanCriteria ab.
getCriteriaValues()Object[]Ruft ein Array von Argumenten für die Kriterien der Regel ab.
getFontColorObject()ColorRuft die Schriftfarbe für diese boolesche Bedingung ab.
getItalic()BooleanGibt true zurück, wenn der boolesche Text kursiv ist, und false, wenn diese boolesche Bedingung kursiv formatiert ist.
getStrikethrough()BooleanGibt true zurück, wenn diese boolesche Bedingung durch den Text durchgestrichen ist, und false, wenn diese boolesche Bedingung durchgestrichen ist.
getUnderline()BooleanGibt true zurück, wenn der boolesche Text den Text unterstrichen hat, und false, wenn die boolesche Bedingung entfernt wurde.

Detaillierte Dokumentation

getBackgroundObject()

Ruft die Hintergrundfarbe für diese boolesche Bedingung ab. Gibt null zurück, wenn kein Wert 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());
}

Zurücksenden

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


getBold()

Gibt true zurück, wenn diese boolesche Bedingung den Text fett formatiert, und false, wenn diese boolesche Bedingung den Text fett formatiert. Gibt null zurück, wenn die Fettformatierung nicht geändert wurde.

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

Zurücksenden

Boolean: Gibt an, ob die boolesche Bedingung den Text fett formatiert, oder null, wenn dies nicht der Fall ist.


getCriteriaType()

Ruft den Kriterientyp der Regel wie in der Aufzählung BooleanCriteria ab. Verwenden Sie getCriteriaValues(), um die Argumente für die Kriterien abzurufen. Informationen zum Verwenden dieser Werte zum Erstellen oder Ändern einer bedingten Formatierung 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);
  }
});

Zurücksenden

BooleanCriteria: Typ der bedingten Formatierung.


getCriteriaValues()

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

Zurücksenden

Object[]: ein Array von Argumenten, die für den Kriterientyp der Regel geeignet sind. Die Anzahl der Argumente und ihr Typ entsprechen der entsprechenden Methode when...() der Klasse ConditionalFormatRuleBuilder.


getFontColorObject()

Ruft die Schriftfarbe für diese boolesche Bedingung ab. Gibt null zurück, wenn kein Wert 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());
}

Zurücksenden

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


getItalic()

Gibt true zurück, wenn der boolesche Text kursiv ist, und false, wenn diese boolesche Bedingung kursiv formatiert ist. Gibt null zurück, wenn Kursiv nicht betroffen ist.

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

Zurücksenden

Boolean: Gibt an, ob der boolesche Text kursiv formatiert ist, oder null, wenn das Kursivzeichen nicht betroffen ist.


getStrikethrough()

Gibt true zurück, wenn diese boolesche Bedingung durch den Text durchgestrichen ist, und false, wenn diese boolesche Bedingung durchgestrichen ist. Gibt null zurück, wenn das Durchstreichen nicht beeinträchtigt 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);
}

Zurücksenden

Boolean: Gibt an, ob die boolesche Bedingung durch den Text durchgestrichen ist oder nicht, wenn der Durchstreichen nicht betroffen ist.


getUnderline()

Gibt true zurück, wenn der boolesche Text den Text unterstrichen hat, und false, wenn die boolesche Bedingung entfernt wurde. Gibt null zurück, wenn die Unterstreichung 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);
}

Zurücksenden

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

Eingestellte Methoden