Zugriff auf boolesche Bedingungen in ConditionalFormatRules
. Jedes
kann die Regel für die bedingte Formatierung eine einzelne boolesche Bedingung enthalten. Die boolesche Bedingung selbst
enthält ein boolesches Kriterium (mit Werten) und Formatierungseinstellungen. Die Kriterien werden bewertet,
gegen den Inhalt einer Zelle, was zu einem true
- oder false
-Wert führt. Wenn die
wird true
zurückgegeben, werden die Formatierungseinstellungen der Bedingung auf die Zelle angewendet.
Methoden
Methode | Rückgabetyp | Kurzbeschreibung |
---|---|---|
getBackgroundObject() | Color | Ruft die Hintergrundfarbe für diese boolesche Bedingung ab. |
getBold() | Boolean | Gibt true zurück, wenn diese boolesche Bedingung den Text fett formatiert. Wenn dies der Fall ist, wird false zurückgegeben.
Mit einer booleschen Bedingung wird der Text fett formatiert. |
getCriteriaType() | BooleanCriteria | Ruft den Kriterientyp der Regel gemäß der Definition in der BooleanCriteria -Enum ab. |
getCriteriaValues() | Object[] | Ruft ein Array von Argumenten für die Kriterien der Regel ab. |
getFontColorObject() | Color | Ruft die Schriftfarbe für diese boolesche Bedingung ab. |
getItalic() | Boolean | Gibt true zurück, wenn diese boolesche Bedingung den Text kursiv formatiert, und false , wenn
Durch diese boolesche Bedingung werden Kursivschrift aus dem Text entfernt. |
getStrikethrough() | Boolean | Gibt true zurück, wenn diese boolesche Bedingung den Text durchgestrichen hat, und false , wenn durch diese boolesche Bedingung der Text durchgestrichen wird. |
getUnderline() | Boolean | Gibt true zurück, wenn diese boolesche Bedingung den Text unterstreicht. Gibt false zurück, wenn
Mit dieser booleschen Bedingung wird der Text unterstrichen. |
Detaillierte Dokumentation
getBackgroundObject()
Ruft die Hintergrundfarbe für diese boolesche Bedingung ab. Gibt null
zurück, wenn nicht festgelegt.
// 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()); }
Rückflug
Color
: Die Hintergrundfarbe oder null
, wenn für diese Bedingung nichts festgelegt ist.
getBold()
Gibt true
zurück, wenn diese boolesche Bedingung den Text fett formatiert. Wenn dies der Fall ist, wird false
zurückgegeben.
Mit einer booleschen Bedingung wird der Text fett formatiert. Gibt null
zurück, wenn das Fettdruck nicht betroffen ist.
// 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); }
Rückflug
Boolean
: Gibt an, ob der Text mit der booleschen Bedingung fett formatiert wird, oder null
, wenn der Text fett formatiert wird
nicht betroffen
getCriteriaType()
Ruft den Kriterientyp der Regel gemäß der Definition in der BooleanCriteria
-Enum ab. Um die
Argumente für die Kriterien, verwenden Sie getCriteriaValues()
. Um diese Werte zu verwenden,
Regeln für die bedingte Formatierung ändern (siehe 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); } });
Rückflug
BooleanCriteria
– die Art 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 Regel für die bedingte Formatierung mithilfe dieser Werte 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); } });
Rückflug
Object[]
: Ein Array von Argumenten, die dem Kriterientyp der Regel entsprechen. die Anzahl der Argumente
und ihr Typ mit der entsprechenden when...()
-Methode der ConditionalFormatRuleBuilder
-Klasse übereinstimmt
getFontColorObject()
Ruft die Schriftfarbe für diese boolesche Bedingung ab. Gibt null
zurück, wenn nicht festgelegt.
// 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()); }
Rückflug
Color
: Die Schriftfarbe oder null
, wenn für diese Bedingung nichts festgelegt ist.
getItalic()
Gibt true
zurück, wenn diese boolesche Bedingung den Text kursiv formatiert, und false
, wenn
Durch diese boolesche Bedingung werden Kursivschrift aus dem Text entfernt. Gibt null
zurück, wenn Kursivschreibungen entsprechen
nicht betroffen sind.
// 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); }
Rückflug
Boolean
– ob der Text durch die boolesche Bedingung kursiv wird, oder null
, wenn
Kursivschrift bleibt davon unberührt
getStrikethrough()
Gibt true
zurück, wenn diese boolesche Bedingung den Text durchgestrichen hat, und false
, wenn durch diese boolesche Bedingung der Text durchgestrichen wird. Gibt null
zurück, wenn
durchgestrichen.
// 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); }
Rückflug
Boolean
– ob die boolesche Bedingung den Text ausgelöst hat, oder null
, wenn
Durchgestrichen ist nicht betroffen
getUnderline()
Gibt true
zurück, wenn diese boolesche Bedingung den Text unterstreicht. Gibt false
zurück, wenn
Mit dieser booleschen Bedingung wird der Text unterstrichen. Gibt null
zurück, wenn es unterstrichen ist
ist davon nicht betroffen.
// 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); }
Rückflug
Boolean
– ob der Text durch die boolesche Bedingung unterstrichen wird, oder null
, wenn
Das Unterstreichen ist davon nicht betroffen