Class BooleanCondition

BooleanCondition

Accedi alle condizioni booleane in ConditionalFormatRules. Ogni regola del formato condizionale può contenere una singola condizione booleana. La condizione booleana stessa contiene un criterio booleano (con valori) e impostazioni di formattazione. I criteri vengono valutati rispetto ai contenuti di una cella e il risultato è un valore true o false. Se il valore di criteria è true, le impostazioni di formattazione della condizione vengono applicate alla cella.

Metodi

MetodoTipo restituitoBreve descrizione
getBackgroundObject()ColorRestituisce il colore di sfondo per questa condizione booleana.
getBold()BooleanRestituisce true se questa condizione booleana mette in grassetto il testo e restituisce false se questa condizione booleana rimuove il grassetto dal testo.
getCriteriaType()BooleanCriteriaRecupera il tipo di criteri della regola come definito nell'enum BooleanCriteria.
getCriteriaValues()Object[]Restituisce un array di argomenti per i criteri della regola.
getFontColorObject()ColorRestituisce il colore del carattere per questa condizione booleana.
getItalic()BooleanRestituisce true se questa condizione booleana mette in corsivo il testo e restituisce false se questa condizione booleana rimuove i caratteri in corsivo dal testo.
getStrikethrough()BooleanRestituisce true se questa condizione booleana barra il testo e restituisce false se questa condizione booleana rimuove il barrato dal testo.
getUnderline()BooleanRestituisce true se questa condizione booleana sottolinea il testo e restituisce false se questa condizione booleana rimuove il sottolineato dal testo.

Documentazione dettagliata

getBackgroundObject()

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

Invio

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

getBold()

Restituisce true se questa condizione booleana mette in grassetto il testo e restituisce false se questa condizione booleana rimuove il grassetto dal testo. Restituisce null se il testo in grassetto non è interessato. 

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

Invio

Boolean: indica se la condizione booleana applica o meno il grassetto al testo oppure null se il grassetto non viene applicato.

getCriteriaType()

Recupera il tipo di criteri della regola come definito nell'enum 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}`);
  }
});

Invio

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

Invio

Object[]: un array di argomenti appropriati al 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. 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()}`);
}

Invio

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

getItalic()

Restituisce true se questa condizione booleana mette in corsivo il testo e restituisce false se questa condizione booleana rimuove i caratteri in corsivo dal testo. Restituisce null se il corsivo non è interessato. 

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

Invio

Boolean: indica se la condizione booleana mette il testo in corsivo o meno oppure null se il testo in corsivo non è interessato

getStrikethrough()

Restituisce true se questa condizione booleana barra il testo e restituisce false se questa condizione booleana rimuove il barrato dal testo. Restituisce null se il testo barrato non è interessato. 

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

Invio

Boolean: indica se la condizione booleana barra o meno il testo oppure null se il testo barrato non è interessato

getUnderline()

Restituisce true se questa condizione booleana sottolinea il testo e restituisce false se questa condizione booleana rimuove il sottolineato dal testo. Restituisce null se l'evidenziazione non è interessata. 

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

Invio

Boolean: indica se la condizione booleana sottolinea o meno il testo oppure null se la sottolineatura non è interessata

Metodi ritirati