Class BooleanCondition

BooleanCondition

Accedi alle condizioni booleane in ConditionalFormatRules. Ogni regola di formattazione condizionale può contenere una singola condizione booleana. La condizione booleana stessa contiene un criterio booleano (con valori) e impostazioni di formattazione. Il criterio viene valutato in base al contenuto di una cella, con un valore true o false. Se il criterio restituisce true, le impostazioni di formattazione della condizione vengono applicate alla cella.

Metodi

MetodoTipo restituitoBreve descrizione
getBackgroundObject()Color|nullOttiene il colore di sfondo per questa condizione booleana.
getBold()Boolean|nullRestituisce true se questa condizione booleana applica il grassetto al testo e false se lo rimuove.
getCriteriaType()BooleanCriteriaOttiene il tipo di criterio della regola come definito nell'enumerazione BooleanCriteria.
getCriteriaValues()Object[]Ottiene un array di argomenti per i criteri della regola.
getFontColorObject()Color|nullOttiene il colore del carattere per questa condizione booleana.
getItalic()Boolean|nullRestituisce true se questa condizione booleana applica il corsivo al testo e false se lo rimuove.
getStrikethrough()Boolean|nullRestituisce true se questa condizione booleana applica il barrato al testo e false se lo rimuove.
getUnderline()Boolean|nullRestituisce true se questa condizione booleana applica la sottolineatura al testo e false se la rimuove.

Documentazione dettagliata

getBackgroundObject()

Ottiene il colore di sfondo per questa condizione booleana. Restituisce null se non è impostato. 

// 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()}`);
}

Indietro

Color|null : il colore di sfondo o null se non è impostato per questa condizione.

getBold()

Restituisce true se questa condizione booleana applica il grassetto al testo e false se lo rimuove. Restituisce null se il grassetto non viene modificato. 

// 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}`);
}

Indietro

Boolean|null : indica se la condizione booleana applica il grassetto al testo o null se il grassetto non viene modificato

getCriteriaType()

Ottiene il tipo di criterio 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.

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}`);
  }
});

Indietro

BooleanCriteria : il tipo di criteri di formattazione condizionale.

getCriteriaValues()

Ottiene un array di argomenti per i criteri della regola. Per ottenere il tipo di criterio, utilizza getCriteriaType(). 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.

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}`);
  }
});

Indietro

Object[] : un array di argomenti appropriati per il tipo di criteri della regola; il numero di argomenti e il relativo tipo corrispondono al metodo when...() della classe ConditionalFormatRuleBuilder.

getFontColorObject()

Ottiene il colore del carattere per questa condizione booleana. Restituisce null se non è impostato. 

// 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()}`);
}

Indietro

Color|null : il colore del carattere o null se non è impostato per questa condizione.

getItalic()

Restituisce true se questa condizione booleana applica il corsivo al testo e false se lo rimuove. Restituisce null se il corsivo non viene modificato. 

// 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}`);
}

Indietro

Boolean|null : indica se la condizione booleana applica il corsivo al testo o null se il corsivo non viene modificato

getStrikethrough()

Restituisce true se questa condizione booleana applica il barrato al testo e false se lo rimuove. Restituisce null se il barrato non viene modificato. 

// 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}`);
}

Indietro

Boolean|null : indica se la condizione booleana applica il barrato al testo o null se il barrato non viene modificato

getUnderline()

Restituisce true se questa condizione booleana applica la sottolineatura al testo e false se la rimuove. Restituisce null se la sottolineatura non viene modificata. 

// 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}`);
}

Indietro

Boolean|null : indica se la condizione booleana applica la sottolineatura al testo o null se la sottolineatura non viene modificata

Metodi ritirati