Accedi alle condizioni booleane in ConditionalFormatRules
. Ogni regola di formattazione condizionale può contenere una singola condizione booleana. La condizione booleana contiene
criteri booleani (con valori) e impostazioni di formattazione. I criteri vengono valutati in base al contenuto di una cella che restituisce un valore true
o false
. Se il criterio restituisce true
, le impostazioni di formattazione della condizione vengono applicate alla cella.
Metodi
Metodo | Tipo restituito | Breve descrizione |
---|---|---|
getBackgroundObject() | Color | Restituisce il colore di sfondo per questa condizione booleana. |
getBold() | Boolean | Restituisce true se questa condizione booleana applica il grassetto al testo e restituisce false se questa condizione booleana rimuove il grassetto dal testo. |
getCriteriaType() | BooleanCriteria | Restituisce il tipo di criteri della regola come definito nell'enumerazione BooleanCriteria . |
getCriteriaValues() | Object[] | Restituisce un array di argomenti per i criteri della regola. |
getFontColorObject() | Color | Restituisce il colore del carattere per questa condizione booleana. |
getItalic() | Boolean | Restituisce true se questa condizione booleana applica il corsivo al testo e restituisce false se
questa condizione booleana rimuove il corsivo dal testo. |
getStrikethrough() | Boolean | Restituisce true se questa condizione booleana barra il testo e restituisce false se questa condizione booleana rimuove il testo barrato. |
getUnderline() | Boolean | Restituisce true se questa condizione booleana sottolinea il testo e restituisce false se questa condizione booleana rimuove la sottolineatura dal testo. |
Documentazione dettagliata
getBackgroundObject()
Restituisce il colore di sfondo per questa condizione booleana. Se non è impostato, restituisce null
.
// 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()); }
Ritorni
Color
: il colore dello sfondo oppure null
se non è impostato per questa condizione.
getBold()
Restituisce true
se questa condizione booleana applica il grassetto al testo e restituisce false
se questa condizione booleana rimuove il grassetto dal testo. Restituisce null
se il grassetto non è interessato.
// 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); }
Ritorni
Boolean
: indica se la condizione booleana applica il grassetto o meno al testo oppure null
se il grassetto non è interessato
getCriteriaType()
Restituisce il tipo di criteri della regola come definito nell'enumerazione BooleanCriteria
. Per ottenere gli argomenti per i criteri, utilizza getCriteriaValues()
. Per utilizzare questi valori per creare o
modificare una regola di formattazione condizionale, consulta 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); } });
Ritorni
BooleanCriteria
: il tipo di criteri di formattazione condizionale
getCriteriaValues()
Restituisce un array di argomenti per i criteri della regola. Per ottenere il tipo di criteri, utilizza getCriteriaType()
. Per utilizzare questi valori per creare o modificare una regola di formattazione condizionale, vedi
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); } });
Ritorni
Object[]
: un array di argomenti appropriato per il tipo di criteri della regola; il numero di argomenti e il relativo tipo corrispondono al metodo when...()
corrispondente della classe ConditionalFormatRuleBuilder
getFontColorObject()
Restituisce il colore del carattere per questa condizione booleana. Se non è impostato, restituisce null
.
// 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()); }
Ritorni
Color
: colore del carattere o null
se non impostato per questa condizione.
getItalic()
Restituisce true
se questa condizione booleana applica il corsivo al testo e restituisce false
se
questa condizione booleana rimuove il corsivo dal testo. Restituisce null
se il corsivo non è interessato.
// 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); }
Ritorni
Boolean
: indica se la condizione booleana applica il corsivo o meno il testo oppure null
se il corsivo non è interessato
getStrikethrough()
Restituisce true
se questa condizione booleana barra il testo e restituisce false
se questa condizione booleana rimuove il testo barrato. Restituisce null
se
il barrato non è interessato.
// 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); }
Ritorni
Boolean
: indica se la condizione booleana viene barrata o meno nel testo oppure null
se
il testo barrato non viene modificato
getUnderline()
Restituisce true
se questa condizione booleana sottolinea il testo e restituisce false
se questa condizione booleana rimuove la sottolineatura dal testo. Restituisce null
se la sottolineatura non è interessata.
// 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); }
Ritorni
Boolean
: se la condizione booleana evidenzia il testo oppure null
se la sottolineatura non viene interessata