Class BooleanCondition

BooleanCondition

Auf boolesche Bedingungen in ConditionalFormatRules zugreifen 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. Die Kriterien werden anhand des Inhalts einer Zelle ausgewertet. Das Ergebnis ist entweder ein true- oder ein false-Wert. Wenn die Kriterien true ergeben, werden die Formatierungseinstellungen der Bedingung auf die Zelle angewendet.

Methoden

MethodeRückgabetypKurzbeschreibung
getBackgroundObject()Color|nullGibt die Hintergrundfarbe für diese boolesche Bedingung zurück.
getBold()Boolean|nullGibt true zurück, wenn der Text durch diese boolesche Bedingung fett formatiert wird, und false, wenn die Fettdruckformatierung des Texts durch diese boolesche Bedingung entfernt 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()Color|nullGibt die Schriftfarbe für diese boolesche Bedingung zurück.
getItalic()Boolean|nullGibt true zurück, wenn der Text durch diese boolesche Bedingung kursiv formatiert wird, und false, wenn die Kursivformatierung durch diese boolesche Bedingung entfernt wird.
getStrikethrough()Boolean|nullGibt true zurück, wenn diese boolesche Bedingung den Text durchstreicht, und false, wenn diese boolesche Bedingung die Durchstreichung des Texts entfernt.
getUnderline()Boolean|nullGibt true zurück, wenn diese boolesche Bedingung den Text unterstreicht, und false, wenn diese boolesche Bedingung die Unterstreichung aus dem Text entfernt.

Detaillierte Dokumentation

getBackgroundObject()

Gibt die Hintergrundfarbe für diese boolesche Bedingung zurück. Gibt null zurück, wenn der Wert 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|null: Die Hintergrundfarbe oder null, wenn sie für diese Bedingung nicht festgelegt ist.

getBold()

Gibt true zurück, wenn der Text durch diese boolesche Bedingung fett formatiert wird, und false, wenn die Fettdruckformatierung des Texts durch diese boolesche Bedingung entfernt wird. Gibt null zurück, wenn die Fettschrift nicht geändert wird. 

// 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|null – ob der Text durch die boolesche Bedingung fett formatiert wird oder null, wenn die Fettformatierung nicht betroffen ist

getCriteriaType()

Ruft den Kriterientyp der Regel ab, wie in der BooleanCriteria-Enumeration definiert. Verwenden Sie getCriteriaValues(), um die Argumente für die Kriterien abzurufen. Informationen dazu, wie Sie diese Werte zum Erstellen oder Ändern einer Regel für die bedingte Formatierung verwenden, finden 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: Der Typ 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. Informationen dazu, wie Sie diese Werte zum Erstellen oder Ändern einer Regel für die bedingte Formatierung verwenden, finden 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, die dem Kriterientyp der Regel entsprechen. Die Anzahl der Argumente und ihr Typ stimmen mit der entsprechenden when...()-Methode der ConditionalFormatRuleBuilder-Klasse überein.

getFontColorObject()

Gibt die Schriftfarbe für diese boolesche Bedingung zurück. Gibt null zurück, wenn der Wert 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|null: Die Schriftfarbe oder null, wenn sie für diese Bedingung nicht 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 entfernt wird. Gibt null zurück, wenn die Kursivformatierung nicht geändert wird. 

// 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|null: Gibt an, ob der Text durch die boolesche Bedingung kursiv formatiert wird. null: Gibt an, dass die Kursivformatierung nicht betroffen ist.

getStrikethrough()

Gibt true zurück, wenn diese boolesche Bedingung den Text durchstreicht, und false, wenn diese boolesche Bedingung die Durchstreichung des Texts entfernt. Gibt null zurück, wenn die Formatierung „Durchgestrichen“ 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|null: Gibt an, ob der Text durch die boolesche Bedingung durchgestrichen wird, oder null, wenn die Durchstreichung nicht betroffen ist.

getUnderline()

Gibt true zurück, wenn diese boolesche Bedingung den Text unterstreicht, und false, wenn diese boolesche Bedingung die Unterstreichung aus dem Text entfernt. Gibt null zurück, wenn die Unterstreichung 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|null – gibt an, ob der Text durch die boolesche Bedingung unterstrichen wird, oder null, wenn die Unterstreichung nicht betroffen ist.

Eingestellte Methoden