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 duy nhất. Bản thân điều kiện boolean chứa tiêu chí boolean (có giá trị) và 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í được đá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 làm nổi bật văn bản và trả về false nếu điều kiện boolean này loại bỏ hiệu ứng làm nổi bật 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á hiệu ứng 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á dấ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 chân văn bản và trả về false nếu điều kiện boolean này xoá phần gạch chân 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 làm nổi bật văn bản và trả về false nếu điều kiện boolean này loại bỏ hiệu ứng làm nổi bật khỏi văn bản. Trả về null nếu việc 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 việc 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 một 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 để tạo hoặc sửa đổi một 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 các đố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ố khớp với phương thức when...() tương ứng 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á hiệu ứng in nghiêng khỏi văn bản. Trả về null nếu kiểu chữ 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 việc 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á dấu gạch ngang khỏi văn bản. Trả về null nếu hiệu ứng 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 chế độ gạch ngang không bị ảnh hưởng


getUnderline()

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

// 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 chân văn bản hay không hoặc null nếu việc gạch chân không bị ảnh hưởng

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