Class BooleanCondition

BooleanCondition

Truy cập vào các điều kiện boolean trong ConditionalFormatRules. Mỗi quy tắc định dạng có điều kiện có thể chứa một điều kiện boolean. Bản thân điều kiện boolean chứa một tiêu chí boolean (có giá trị) và các chế độ cài đặt định dạng. Tiêu chí được đánh giá dựa trên nội dung của một ô, dẫn đến giá trị true hoặc false. Nếu tiêu chí đánh giá là true, thì chế độ cài đặt định dạng của điều kiện sẽ được áp dụng cho ô.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
getBackgroundObject()Color|nullLấy màu nền cho điều kiện boolean này.
getBold()Boolean|nullTrả về true nếu điều kiện Boolean này in đậm văn bản và trả về false nếu điều kiện Boolean này xoá kiểu in đậm khỏi văn bản.
getCriteriaType()BooleanCriteriaLấy loại tiêu chí của quy tắc như được xác định trong enum BooleanCriteria.
getCriteriaValues()Object[]Lấy một mảng đối số cho tiêu chí của quy tắc.
getFontColorObject()Color|nullLấy màu phông chữ cho điều kiện boolean này.
getItalic()Boolean|nullTrả về true nếu điều kiện boolean này in nghiêng văn bản và trả về false nếu điều kiện boolean này xoá kiểu in nghiêng khỏi văn bản.
getStrikethrough()Boolean|nullTrả về true nếu điều kiện boolean này gạch ngang văn bản và trả về false nếu điều kiện boolean này xoá kiểu gạch ngang khỏi văn bản.
getUnderline()Boolean|nullTrả về true nếu điều kiện boolean này gạch dưới văn bản và trả về false nếu điều kiện boolean này xoá kiểu gạch dưới khỏi văn bản.

Tài liệu chi tiết

getBackgroundObject()

Lấy màu nền cho điều kiện boolean này. Trả về null nếu không được đặt.

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

Cầu thủ trả bóng

Color|null – Màu nền hoặc null nếu không được đặt cho điều kiện này.


getBold()

Trả về true nếu điều kiện Boolean này in đậm văn bản và trả về false nếu điều kiện Boolean này xoá kiểu in đậm khỏi văn bản. Trả về null nếu kiểu in đậm không bị ảnh hưởng.

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

Cầu thủ trả bóng

Boolean|null – liệu điều kiện boolean có in đậm văn bản hay không hoặc null nếu kiểu in đậm không bị ảnh hưởng


getCriteriaType()

Lấy loại tiêu chí của quy tắc như được xác định trong enum BooleanCriteria. Để lấy các đối số cho tiêu chí, hãy sử dụng getCriteriaValues(). Để sử dụng các giá trị này nhằm tạo hoặc sửa đổi quy tắc định dạng có điều kiện, hãy xem 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}`);
  }
});

Cầu thủ trả bóng

BooleanCriteria – Loại tiêu chí định dạng có điều kiện.


getCriteriaValues()

Lấy một mảng đối số cho tiêu chí của quy tắc. Để lấy loại tiêu chí, hãy sử dụng getCriteriaType(). Để sử dụng các giá trị này nhằm tạo hoặc sửa đổi quy tắc định dạng có điều kiện, hãy xem 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}`);
  }
});

Cầu thủ trả bóng

Object[] – Một mảng đối số phù hợp với loại tiêu chí của quy tắc; số lượng đối số và loại đối số tương ứng với phương thức when...() của lớp ConditionalFormatRuleBuilder.


getFontColorObject()

Lấy màu phông chữ cho điều kiện boolean này. Trả về null nếu không được đặt.

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

Cầu thủ trả bóng

Color|null – Màu phông chữ hoặc null nếu không được đặt cho điều kiện này.


getItalic()

Trả về true nếu điều kiện boolean này in nghiêng văn bản và trả về false nếu điều kiện boolean này xoá kiểu in nghiêng khỏi văn bản. Trả về null nếu kiểu in nghiêng không bị ảnh hưởng.

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

Cầu thủ trả bóng

Boolean|null – liệu điều kiện boolean có in nghiêng văn bản hay không hoặc null nếu kiểu in nghiêng không bị ảnh hưởng


getStrikethrough()

Trả về true nếu điều kiện boolean này gạch ngang văn bản và trả về false nếu điều kiện boolean này xoá kiểu gạch ngang khỏi văn bản. Trả về null nếu kiểu gạch ngang không bị ảnh hưởng.

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

Cầu thủ trả bóng

Boolean|null – liệu điều kiện boolean có gạch ngang văn bản hay không hoặc null nếu kiểu gạch ngang không bị ảnh hưởng


getUnderline()

Trả về true nếu điều kiện boolean này gạch dưới văn bản và trả về false nếu điều kiện boolean này xoá kiểu gạch dưới khỏi văn bản. Trả về null nếu kiểu gạch dưới không bị ảnh hưởng.

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

Cầu thủ trả bóng

Boolean|null – liệu điều kiện boolean có gạch dưới văn bản hay không hoặc null nếu kiểu gạch dưới không bị ảnh hưởng

Các phương thức ngừng hoạt động