Questa pagina è stata tradotta dall'API Cloud Translation.

Class BooleanCondition

Accedi alle condizioni booleane in ConditionalFormatRules. Ogni regola del formato condizionale può contenere una singola condizione booleana. La condizione booleana stessa contiene i criteri booleani (con valori) e le 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

Metodo	Tipo restituito	Breve descrizione
`getBackgroundObject()`	`Color`	Restituisce il colore di sfondo per questa condizione booleana.
`getBold()`	`Boolean`	Restituisce `true` se questa condizione booleana mette in grassetto il testo e restituisce `false` se questa condizione booleana rimuove il grassetto dal testo.
`getCriteriaType()`	`BooleanCriteria`	Recupera il tipo di criteri della regola come definito nell'enum `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 mette in corsivo il testo e restituisce `false` se questa condizione booleana rimuove i caratteri in corsivo dal testo.
`getStrikethrough()`	`Boolean`	Restituisce `true` se questa condizione booleana barra il testo e restituisce `false` se questa condizione booleana rimuove il barrato dal testo.
`getUnderline()`	`Boolean`	Restituisce `true` se questa condizione booleana sottolinea il testo e restituisce `false` se questa condizione booleana rimuove il sottolineato dal testo.

Metodi ritirati

Metodo	Tipo restituito	Breve descrizione
`getBackground()`	`String`	Recupera la stringa del colore di sfondo per questa condizione booleana.
`getFontColor()`	`String`	Recupera la stringa del colore del carattere per questa condizione booleana.

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

`getBackground()`

Ritiro. Sostituito da getBackgroundObject()

Recupera la stringa del 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().getBackground();
  Logger.log(`Background color: ${color}`);
}

Invio

String: la stringa del colore di sfondo o null se non è impostata per questa condizione.

`getFontColor()`

Ritiro. Sostituito da getFontColorObject()

Recupera la stringa del 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) {
  Logger.log(`Font color: ${rule.getBooleanCondition().getFontColor()}`);
}

Invio

String: la stringa del colore del carattere o null se non è impostata per questa condizione.