Trang này được dịch bởi Cloud Translation API.

Class 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ức	Loại dữ liệu trả về	Mô tả ngắn
`getBackgroundObject()`	`Color`	Lấy màu nền cho điều kiện boolean này.
`getBold()`	`Boolean`	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á in đậm khỏi văn bản.
`getCriteriaType()`	`BooleanCriteria`	Lấ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`	Lấy màu phông chữ cho điều kiện boolean này.
`getItalic()`	`Boolean`	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á in nghiêng khỏi văn bản.
`getStrikethrough()`	`Boolean`	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.
`getUnderline()`	`Boolean`	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á gạch chân khỏi văn bản.

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

Phương thức	Loại dữ liệu trả về	Mô tả ngắn
`getBackground()`	`String`	Lấy chuỗi màu nền cho điều kiện boolean này.
`getFontColor()`	`String`	Lấy chuỗi màu phông chữ cho điều kiện boolean này.

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 – 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á in đậm khỏi văn bản. Trả về null nếu không ảnh hưởng đến việc in đậm.

// 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 – 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 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ố 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 – 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á 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 – 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 văn bản 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 – liệu điều kiện boolean có gạch ngang văn bản hay không hoặc null nếu văn bản không bị gạch ngang

`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á gạch chân khỏi văn bản. Trả về null nếu không ảnh hưởng đến việc 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 – 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

`getBackground()`

Không dùng nữa. Được thay thế bằng getBackgroundObject()

Lấy chuỗi 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().getBackground();
  Logger.log(`Background color: ${color}`);
}

Cầu thủ trả bóng

String – Chuỗi màu nền hoặc null nếu không được đặt cho điều kiện này.

`getFontColor()`

Không dùng nữa. Được thay thế bằng getFontColorObject()

Lấy chuỗi 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) {
  Logger.log(`Font color: ${rule.getBooleanCondition().getFontColor()}`);
}

Cầu thủ trả bóng

String – Chuỗi màu phông chữ hoặc null nếu không được đặt cho điều kiện này.