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 kryteria logiczne (z wartościami) i ustawienia formatowania. Kryteria są oceniane na podstawie zawartości komórki, co daje wartość true lub false. Jeśli kryteria mają wartość true, do komórki stosowane są ustawienia formatowania warunku.

Metody

MetodaZwracany typKrótki opis
getBackgroundObject()Color|nullPobiera kolor tła tego warunku logicznego.
getBold()Boolean|nullZwraca wartość true, jeśli ten warunek logiczny pogrubia tekst, i wartość false, jeśli ten warunek logiczny usuwa pogrubienie tekstu.
getCriteriaType()BooleanCriteriaPobiera typ kryteriów reguły zdefiniowany w wyliczeniu BooleanCriteria.
getCriteriaValues()Object[]Pobiera tablicę argumentów dla kryteriów reguły.
getFontColorObject()Color|nullPobiera kolor czcionki dla tego warunku logicznego.
getItalic()Boolean|nullZwraca true, jeśli ten warunek logiczny powoduje kursywę tekstu, i false, jeśli ten warunek logiczny usuwa kursywę z tekstu.
getStrikethrough()Boolean|nullZwraca true, jeśli ten warunek logiczny przekreśla tekst, i false, jeśli ten warunek logiczny usuwa przekreślenie z tekstu.
getUnderline()Boolean|nullZwraca wartość true, jeśli ten warunek logiczny podkreśla tekst, lub false, jeśli ten warunek logiczny usuwa podkreślenie z tekstu.

Szczegółowa dokumentacja

getBackgroundObject()

Pobiera kolor tła tego warunku logicznego. Jeśli nie jest ustawiona, zwraca wartość 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|null – kolor tła lub null, jeśli nie jest ustawiony dla tego warunku.


getBold()

Zwraca wartość true, jeśli ten warunek logiczny pogrubia tekst, i wartość false, jeśli ten warunek logiczny usuwa pogrubienie 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|null – czy warunek logiczny pogrubia tekst, czy null, jeśli pogrubienie nie ma wpływu.


getCriteriaType()

Pobiera typ kryteriów reguły zdefiniowany w wyliczeniu BooleanCriteria. Aby uzyskać argumenty kryteriów, użyj funkcji 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 kryterium, użyj getCriteriaType(). Aby użyć tych wartości do utworzenia lub zmodyfikowania reguły formatowania warunkowego, zapoznaj się z tym 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 dla typu kryterium reguły; liczba argumentów i ich typ są zgodne z odpowiednią metodą when...() klasy ConditionalFormatRuleBuilder.


getFontColorObject()

Pobiera kolor czcionki dla tego warunku logicznego. Jeśli nie jest ustawiona, zwraca wartość 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|null – kolor czcionki lub null, jeśli nie jest ustawiony dla tego warunku.


getItalic()

Zwraca true, jeśli ten warunek logiczny powoduje kursywę tekstu, i false, jeśli ten warunek logiczny usuwa kursywę z tekstu. Zwraca wartość null, jeśli kursywa nie uległa zmianie.

// 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|null – czy warunek logiczny powoduje pochylenie tekstu, czy null jeśli pochylenie nie ma wpływu.


getStrikethrough()

Zwraca true, jeśli ten warunek logiczny przekreśla tekst, i false, jeśli ten warunek logiczny usuwa przekreślenie z tekstu. Zwraca null, jeśli przekreślenie nie ma wpływu.

// 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|null – czy warunek logiczny przekreśla tekst, czy null, jeśli przekreślenie nie ma wpływu.


getUnderline()

Zwraca wartość true, jeśli ten warunek logiczny podkreśla tekst, lub false, jeśli ten warunek logiczny usuwa podkreślenie z tekstu. Zwraca null, jeśli podkreślenie nie uległo zmianie.

// 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|null – czy warunek logiczny podkreśla tekst, czy null, jeśli podkreślenie nie ma wpływu.

Wycofane metody