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

MethodeRückgabetypKurzbeschreibung
getBackgroundObject()ColorDie Hintergrundfarbe für diese boolesche Bedingung.
getBold()BooleanGibt 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()BooleanCriteriaRuft 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()ColorDie Schriftfarbe für diese boolesche Bedingung.
getItalic()BooleanGibt 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()BooleanGibt true zurück, wenn dieser boolesche Ausdruck den Text durchgestrichen darstellt, und false, wenn dieser boolesche Ausdruck den Durchstrich aus dem Text entfernt.
getUnderline()BooleanGibt true zurück, wenn der Text durch diese boolesche Bedingung unterstrichen wird, und false, wenn das Unterstreichen durch diese boolesche Bedingung aufgehoben wird.

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