Class BooleanCondition

BooleanCondition

Accedi alle condizioni booleane in ConditionalFormatRules. Ogni regola di formattazione condizionale può contenere una sola 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, restituendo un valore true o false. Se i criteri restituiscono 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 mette il testo in grassetto e restituisce false se questa condizione booleana rimuove il grassetto dal testo.
getCriteriaType()BooleanCriteriaRecupera il tipo di criteri della regola come definito nell'enumerazione BooleanCriteria.
getCriteriaValues()Object[]Recupera 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 mette il testo in corsivo e restituisce false se questa condizione booleana rimuove il corsivo dal testo.
getStrikethrough()Boolean|nullRestituisce true se questa condizione booleana sbarra il testo e restituisce false se questa condizione booleana rimuove la sbarratura dal testo.
getUnderline()Boolean|nullRestituisce true se questa condizione booleana sottolinea il testo e restituisce false se questa condizione booleana rimuove la sottolineatura dal testo.

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 mette il testo in grassetto e restituisce false se questa condizione booleana rimuove il grassetto dal testo. Restituisce null se la formattazione in grassetto non è interessata. 

// 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 mette in grassetto il testo o null se il grassetto non è interessato

getCriteriaType()

Recupera 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.

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()

Recupera 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 loro tipo corrispondono al metodo when...() corrispondente 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 mette il testo in corsivo 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.
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 mette il testo in corsivo o null se il corsivo non viene modificato

getStrikethrough()

Restituisce true se questa condizione booleana sbarra il testo e restituisce false se questa condizione booleana rimuove la sbarratura dal testo. Restituisce null se la linea orizzontale non è interessata. 

// 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 barra il testo o null se la barratura non è interessata

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.
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 sottolinea il testo o null se la sottolineatura non è interessata

Metodi ritirati