Class BooleanCondition

BooleanCondition

Auf boolesche Bedingungen in ConditionalFormatRules zugreifen Jede bedingte Formatierungsregel kann eine einzelne boolesche Bedingung enthalten. Die boolesche Bedingung selbst enthält boolesche Kriterien (mit Werten) und Formatierungseinstellungen. Die Kriterien werden anhand des Inhalts einer Zelle ausgewertet, was zu einem true- oder false-Wert führt. Wenn das Ergebnis der Kriterien true ist, werden die Formatierungseinstellungen der Bedingung auf die Zelle angewendet.

Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getBackgroundObject()	Color	Die Hintergrundfarbe für diese boolesche Bedingung.
getBold()	Boolean	Gibt true zurück, wenn der Text durch diese boolesche Bedingung fett formatiert wird, und false, wenn das Fettformat durch diese boolesche Bedingung aufgehoben wird.
getCriteriaType()	BooleanCriteria	Ruft den Kriterientyp der Regel ab, wie in der BooleanCriteria-Enumeration definiert.
getCriteriaValues()	Object[]	Ruft ein Array von Argumenten für die Kriterien der Regel ab.
getFontColorObject()	Color	Die Schriftfarbe für diese boolesche Bedingung.
getItalic()	Boolean	Gibt true zurück, wenn der Text durch diese boolesche Bedingung kursiv formatiert wird, und false, wenn die Kursivschrift durch diese boolesche Bedingung aufgehoben wird.
getStrikethrough()	Boolean	Gibt true zurück, wenn dieser boolesche Ausdruck den Text durchgestrichen darstellt, und false, wenn dieser boolesche Ausdruck den Durchstrich aus dem Text entfernt.
getUnderline()	Boolean	Gibt true zurück, wenn der Text durch diese boolesche Bedingung unterstrichen wird, und false, wenn das Unterstreichen durch diese boolesche Bedingung aufgehoben wird.

Eingestellte Methoden

Methode	Rückgabetyp	Kurzbeschreibung
getBackground()	String	Hier wird der String für die Hintergrundfarbe für diese boolesche Bedingung abgerufen.
getFontColor()	String	Ruft den Schriftfarben-String für diese boolesche Bedingung ab.

Detaillierte Dokumentation

getBackgroundObject()

Die Hintergrundfarbe für diese boolesche Bedingung. Gibt null zurück, wenn sie nicht festgelegt ist.

// Logs the boolean condition background color for each conditional format rule
// on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const color = rule.getBooleanCondition().getBackgroundObject();
  Logger.log(`Background color: ${color.asRgbColor().asHexString()}`);
}

Rückflug

Color: Die Hintergrundfarbe oder null, wenn für diese Bedingung keine Farbe festgelegt ist.

---

getBold()

Gibt true zurück, wenn der Text durch diese boolesche Bedingung fett formatiert wird, und false, wenn das Fettformat durch diese boolesche Bedingung aufgehoben wird. Gibt null zurück, wenn die Fettung nicht betroffen ist.

// Logs the boolean condition font weight for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const bold = rule.getBooleanCondition().getBold();
  Logger.log(`Bold: ${bold}`);
}

Rückflug

Boolean – ob der Text durch die boolesche Bedingung fett formatiert wird oder nicht, oder null, wenn das Fettformatieren nicht geändert wird

---

getCriteriaType()

Ruft den Kriterientyp der Regel ab, wie in der BooleanCriteria-Enumeration definiert. Verwenden Sie getCriteriaValues(), um die Argumente für die Kriterien abzurufen. Wie Sie diese Werte verwenden, um eine Regel für die bedingte Formatierung zu erstellen oder zu ändern, erfahren Sie unter ConditionalFormatRuleBuilder.withCriteria(criteria, args).

// Log information about the conditional formats on the active sheet that use
// boolean conditions.

const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats();
SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => {
  const booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    const criteria = booleanCondition.getCriteriaType();
    const args = booleanCondition.getCriteriaValues();
    Logger.log(`The conditional format rule is ${criteria} ${args}`);
  }
});

Rückflug

BooleanCriteria: Die Art der Kriterien für die bedingte Formatierung.

---

getCriteriaValues()

Ruft ein Array von Argumenten für die Kriterien der Regel ab. Verwenden Sie getCriteriaType(), um den Kriterientyp abzurufen. Wie Sie mit diesen Werten eine Regel für die bedingte Formatierung erstellen oder ändern, erfahren Sie unter ConditionalFormatRuleBuilder.withCriteria(criteria, args).

// Log information about the conditional formats on the active sheet that use
// boolean conditions.

const formats = SpreadsheetApp.getActiveSheet.getConditionalFormats();
SpreadsheetApp.getActiveSheet.getConditionalFormats().forEach((format) => {
  const booleanCondition = format.getBooleanCondition();
  if (booleanCondition) {
    const criteria = booleanCondition.getCriteriaType();
    const args = booleanCondition.getCriteriaValues();
    Logger.log(`The conditional format rule is ${criteria} ${args}`);
  }
});

Rückflug

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

---

getFontColorObject()

Die Schriftfarbe für diese boolesche Bedingung. Gibt null zurück, wenn sie nicht festgelegt ist.

// Logs the boolean condition font color for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const color = rule.getBooleanCondition().getFontColorObject();
  Logger.log(`Font color: ${color.asRgbColor().asHexString()}`);
}

Rückflug

Color: Schriftfarbe oder null, wenn für diese Bedingung nichts festgelegt ist.

---

getItalic()

Gibt true zurück, wenn der Text durch diese boolesche Bedingung kursiv formatiert wird, und false, wenn die Kursivformatierung durch diese boolesche Bedingung aufgehoben wird. Gibt null zurück, wenn Kursivschrift nicht betroffen ist.

// Logs the boolean condition font style for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const italic = rule.getBooleanCondition().getItalic();
  Logger.log(`Italic: ${italic}`);
}

Rückflug

Boolean – gibt an, ob der Text durch die boolesche Bedingung kursiv formatiert wird, oder null, wenn die Formatierung nicht geändert wird

---

getStrikethrough()

Gibt true zurück, wenn dieser boolesche Ausdruck den Text durchgestrichen darstellt, und false, wenn dieser boolesche Ausdruck den Durchstrich aus dem Text entfernt. Gibt null zurück, wenn das Durchstreichen nicht betroffen ist.

// Logs the boolean condition strikethrough setting for each conditional format
// rule on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const strikethrough = rule.getBooleanCondition().getStrikethrough();
  Logger.log(`Strikethrough: ${strikethrough}`);
}

Rückflug

Boolean: Gibt an, ob der Text durchgestrichen wird, oder null, wenn der Text nicht durchgestrichen wird.

---

getUnderline()

Gibt true zurück, wenn der Text durch diese boolesche Bedingung unterstrichen wird, und false, wenn das Unterstreichen durch diese boolesche Bedingung aufgehoben 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.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const underline = rule.getBooleanCondition().getUnderline();
  Logger.log(`Underline: ${underline}`);
}

Rückflug

Boolean – ob der Text durch die boolesche Bedingung unterstrichen wird oder nicht, oder null, wenn das Unterstreichen nicht beeinflusst wird

Eingestellte Methoden

getBackground()

Veraltet. Ersetzt durch getBackgroundObject()

Hier wird der String für die Hintergrundfarbe für diese boolesche Bedingung abgerufen. Gibt null zurück, wenn sie nicht festgelegt ist.

// Logs the boolean condition background color for each conditional format rule
// on a sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  const color = rule.getBooleanCondition().getBackground();
  Logger.log(`Background color: ${color}`);
}

Rückflug

String: Der String für die Hintergrundfarbe oder null, wenn für diese Bedingung nichts festgelegt ist.

---

getFontColor()

Veraltet. Ersetzt durch getFontColorObject()

Ruft den Schriftfarben-String für diese boolesche Bedingung ab. Gibt null zurück, wenn sie nicht festgelegt ist.

// Logs the boolean condition font color for each conditional format rule on a
// sheet.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (const rule of rules) {
  Logger.log(`Font color: ${rule.getBooleanCondition().getFontColor()}`);
}

Rückflug

String: Der Schriftfarben-String oder null, wenn für diese Bedingung nichts festgelegt ist.