Эта страница переведена с помощью Cloud Translation API.

Class BooleanCondition

Доступ к логическим условиям в Conditional Format Rules . Каждое правило условного формата может содержать одно логическое условие. Само логическое условие содержит логические критерии (со значениями) и настройки форматирования. Критерий оценивается по содержимому ячейки, что приводит к true или false значению. Если критерий имеет значение true , к ячейке применяются параметры форматирования условия.

Методы

Метод	Тип возврата	Краткое описание
`get Background Object()`	`Color`	Получает цвет фона для этого логического условия.
`get Bold()`	`Boolean`	Возвращает `true` , если это логическое условие выделяет текст жирным шрифтом, и возвращает `false` если это логическое условие удаляет выделение из текста.
`get Criteria Type()`	`Boolean Criteria`	Получает тип критерия правила, определенный в перечислении `Boolean Criteria` .
`get Criteria Values()`	`Object[]`	Получает массив аргументов для критериев правила.
`get Font Color Object()`	`Color`	Получает цвет шрифта для этого логического условия.
`get Italic()`	`Boolean`	Возвращает `true` , если это логическое условие выделяет текст курсивом, и возвращает `false` если это логическое условие удаляет курсив из текста.
`get Strikethrough()`	`Boolean`	Возвращает `true` , если это логическое условие зачеркивает текст, и возвращает `false` если это логическое условие удаляет зачеркивание из текста.
`get Underline()`	`Boolean`	Возвращает `true` , если это логическое условие подчеркивает текст, и возвращает `false` если это логическое условие удаляет подчеркивание из текста.

Устаревшие методы

Метод	Тип возврата	Краткое описание
`get Background()`	`String`	Получает строку цвета фона для этого логического условия.
`get Font Color()`	`String`	Получает строку цвета шрифта для этого логического условия.

Подробная документация

`get Background Object()`

Получает цвет фона для этого логического условия. Возвращает 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()}`);
}

Возвращаться

Color — цвет фона или null , если оно не установлено для этого условия.

`get Bold()`

Возвращает true , если это логическое условие выделяет текст жирным шрифтом, и возвращает false если это логическое условие удаляет выделение из текста. Возвращает значение null если выделение жирным шрифтом не изменено.

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

Возвращаться

Boolean — указывает, выделяет ли текст жирным шрифтом логическое условие, или null , если выделение жирным шрифтом не затрагивается.

`get Criteria Type()`

Получает тип критерия правила, определенный в перечислении Boolean Criteria . Чтобы получить аргументы для критериев, используйте get Criteria Values() . Чтобы использовать эти значения для создания или изменения правила условного форматирования, см. раздел Conditional Format Rule Builder.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}`);
  }
});

Возвращаться

Boolean Criteria — тип критериев условного форматирования.

`get Criteria Values()`

Получает массив аргументов для критериев правила. Чтобы получить тип критерия, используйте get Criteria Type() . Чтобы использовать эти значения для создания или изменения правила условного форматирования, см. раздел Conditional Format Rule Builder.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}`);
  }
});

Возвращаться

Object[] — Массив аргументов, соответствующих типу критериев правила; количество аргументов и их тип соответствуют соответствующему методу when...() класса Conditional Format Rule Builder .

`get Font Color Object()`

Получает цвет шрифта для этого логического условия. Возвращает 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()}`);
}

Возвращаться

Color — цвет шрифта или null , если оно не установлено для этого условия.

`get Italic()`

Возвращает true , если это логическое условие выделяет текст курсивом, и возвращает false если это логическое условие удаляет курсив из текста. Возвращает значение null если курсив не изменен.

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

Возвращаться

Boolean — независимо от того, выделяет ли текст курсивом логическое условие, или null , если курсив не затрагивается.

`get Strikethrough()`

Возвращает true , если это логическое условие зачеркивает текст, и возвращает false если это логическое условие удаляет зачеркивание из текста. Возвращает null если зачеркивание не затронуто.

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

Возвращаться

Boolean — зачеркивается ли логическое условие в тексте или null , если зачеркивание не затронуто.

`get Underline()`

Возвращает true , если это логическое условие подчеркивает текст, и возвращает false если это логическое условие удаляет подчеркивание из текста. Возвращает null если подчеркивание не изменено.

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

Возвращаться

Boolean — подчеркивает ли логическое условие текст или null , если подчеркивание не затрагивается.

Устаревшие методы

`get Background()`

Устарело. Заменено на get Background Object()

Получает строку цвета фона для этого логического условия. Возвращает 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}`);
}

Возвращаться

String — строка цвета фона или null , если для этого условия не установлено.

`get Font Color()`

Устарело. Заменено на get Font Color Object()

Получает строку цвета шрифта для этого логического условия. Возвращает 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()}`);
}

Возвращаться

String — строка цвета шрифта или null , если не установлено для этого условия.