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. Kryterium jest 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

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

Wycofane metody

Metoda	Zwracany typ	Krótki opis
getBackground()	String|null	Pobiera ciąg znaków koloru tła dla tego warunku logicznego.
getFontColor()	String|null	Pobiera ciąg znaków koloru czcionki dla tego warunku logicznego.

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 wartość true, jeśli ten warunek logiczny przekreśla tekst, lub false, jeśli 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 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

getBackground()

Wycofano. Zastąpione przez: getBackgroundObject()

Pobiera ciąg znaków koloru tła dla 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().getBackground();
  Logger.log(`Background color: ${color}`);
}

Powrót

String|null – ciąg koloru tła lub null, jeśli nie jest ustawiony dla tego warunku.

---

getFontColor()

Wycofano. Zastąpione przez: getFontColorObject()

Zwraca ciąg znaków koloru 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) {
  Logger.log(`Font color: ${rule.getBooleanCondition().getFontColor()}`);
}

Powrót

String|null – ciąg tekstowy koloru czcionki lub null, jeśli nie jest ustawiony dla tego warunku.