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

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

Wycofane metody

Metoda	Zwracany typ	Krótki opis
getBackground()	String	Pobiera ciąg znaków z kolorem tła dla tej zmiennej logicznej.
getFontColor()	String	Pobiera ciąg znaków odpowiadający kolorowi czcionki dla tej zmiennej logicznej.

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 powodować pogrubienie tekstu, 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 dla 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 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

getBackground()

Wycofany. Zastąpiony przez: getBackgroundObject()

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

Powrót

String – ciąg znaków koloru tła lub null, jeśli nie jest ustawiony w przypadku tego warunku.

---

getFontColor()

Wycofany. Zastąpiony przez: getFontColorObject()

Pobiera ciąg znaków odpowiadający kolorowi czcionki dla tej zmiennej logicznej. 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) {
  Logger.log(`Font color: ${rule.getBooleanCondition().getFontColor()}`);
}

Powrót

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