Class BooleanCondition

BooleanCondition

Dostęp do warunków logicznych w ConditionalFormatRules. Każda reguła formatowania warunkowego może zawierać jeden warunek logiczny. Warunek logiczny zawiera kryterium logiczne (z wartościami) i ustawienia formatowania. Kryterium jest oceniane na podstawie zawartości komórki, która zwraca wartość true lub false. Jeśli warunek true jest spełniony, do komórki zostaną zastosowane ustawienia formatowania warunku.

Metody

MetodaZwracany typKrótki opis
getBackgroundObject()ColorPobiera kolor tła dla tej zmiennej logicznej.
getBold()BooleanZwraca true, jeśli ta warunek logiczny powoduje pogrubienie tekstu, oraz false, jeśli ten warunek logiczny powoduje usunięcie pogrubienia z tekstu.
getCriteriaType()BooleanCriteriaPobiera typ kryteriów reguły z typu wyliczenia BooleanCriteria.
getCriteriaValues()Object[]Pobiera tablicę argumentów dla kryteriów reguły.
getFontColorObject()ColorPobiera kolor czcionki dla tego warunku logicznego.
getItalic()BooleanZwraca true, jeśli ten warunek logiczny powoduje pogrubienie tekstu, oraz false, jeśli powoduje usunięcie pogrubienia.
getStrikethrough()BooleanZwraca true, jeśli ten warunek logiczny przekreśla tekst, oraz false, jeśli usuwa przekreślenie z tekstu.
getUnderline()BooleanZwraca true, jeśli ta warunek logiczny podkreśl tekst, oraz false, jeśli usuwa podkreślenie z tekstu.

Szczegółowa dokumentacja

getBackgroundObject()

Pobiera kolor tła dla tej zmiennej logicznej. Jeśli nie zostanie ustawiony, zwraca null. 

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

Powrót

Color – kolor tła lub null, jeśli nie jest ustawiony dla tego warunku.

getBold()

Zwraca true, jeśli ta warunek logiczny powoduje pogrubienie tekstu, oraz false, jeśli ten warunek logiczny powoduje usunięcie pogrubienia z tekstu. Zwraca null, jeśli pogrubienie nie zostało zmienione. 

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

Powrót

Boolean – czy warunek logiczny ma pogrubić tekst, czy nie (wartość null oznacza, że pogrubienie nie ma wpływu).

getCriteriaType()

Pobiera typ kryteriów reguły z typu wyliczenia BooleanCriteria. Aby uzyskać argumenty dla kryteriów, użyj getCriteriaValues(). Aby użyć tych wartości do utworzenia lub zmodyfikowania reguły formatowania warunkowego, zapoznaj się z artykułem 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}`);
  }
});

Powrót

BooleanCriteria – typ kryteriów formatowania warunkowego.

getCriteriaValues()

Pobiera tablicę argumentów dla kryteriów reguły. Aby uzyskać typ kryteriów, użyj właściwości getCriteriaType(). Aby użyć tych wartości do utworzenia lub zmodyfikowania reguły formatowania warunkowego, zapoznaj się z artykułem 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}`);
  }
});

Powrót

Object[] – tablica argumentów odpowiednich do typu kryteriów reguły; liczba argumentów i ich typ odpowiadają odpowiadającej metodzie when...() klasy ConditionalFormatRuleBuilder.

getFontColorObject()

Pobiera kolor czcionki dla tego warunku logicznego. Jeśli nie zostanie ustawiony, zwraca null. 

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

Powrót

Color – kolor czcionki lub null, jeśli nie jest ustawiony w przypadku tego warunku.

getItalic()

Zwraca true, jeśli ten warunek logiczny powoduje pogrubienie tekstu, oraz false, jeśli powoduje usunięcie pogrubienia. Zwraca null, jeśli kursywa nie jest uwzględniana. 

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

Powrót

Boolean – określa, czy warunek logiczny powoduje pochylenie tekstu (wartość Boolean) czy nie (wartość null).

getStrikethrough()

Zwraca true, jeśli ten warunek logiczny przekreśla tekst, oraz false, jeśli usuwa przekreślenie z tekstu. Zwraca wartość null, jeśli przekreślenie nie jest dotknięte. 

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

Powrót

Boolean — określa, czy warunek logiczny przekreśla tekst (wartość Boolean) czy nie (wartość null).

getUnderline()

Zwraca true, jeśli ta warunek logiczny podkreśl tekst, oraz false, jeśli usuwa podkreślenie z tekstu. Zwraca null, jeśli podkreślenie nie jest dotknięte. 

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

Powrót

Boolean – określa, czy warunek logiczny ma podkreślać tekst (wartość Boolean) czy nie (wartość null).

Wycofane metody