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 im BooleanCriteria-Enum 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 Kursivformatierung 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. |
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 im BooleanCriteria-Enum 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: Gibt an, ob der Text durch die boolesche Bedingung unterstrichen wird, oder null, wenn das Unterstreichen nicht beeinflusst wird.