Questa pagina è stata tradotta dall'API Cloud Translation.

Class BooleanCondition

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.

Metodi deprecati

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

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

Metodi deprecati

`getBackground()`

Obsoleta. Sostituito da getBackgroundObject()

Restituisce la stringa del 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().getBackground();
  Logger.log("The background color for rule %s is %s", i, color);
}

Ritorni

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

`getFontColor()`

Obsoleta. Sostituito da getFontColorObject()

Restituisce la stringa del 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().getFontColor();
  Logger.log("The font color for rule %s is %s", i, color);
}

Ritorni

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