Class ConditionalFormatRule

Quy tắcđịnhdạngcó điều kiện

Truy cập vào các quy tắc định dạng có điều kiện. Để tạo một quy tắc mới, hãy sử dụng SpreadsheetApp.newConditionalFormatRule()ConditionalFormatRuleBuilder. Bạn có thể sử dụng Sheet.setConditionalFormatRules(rules) để đặt các quy tắc cho một trang tính nhất định.

Đối với các quy tắc sử dụng tiêu chí điều kiện boolean, bạn có thể truy cập vào chế độ cài đặt định dạng bằng cách gọi getBooleanCondition() và sử dụng các phương thức trên đối tượng BooleanCondition được trả về.

Phương thức

Phương thứcKiểu dữ liệu trả vềMô tả ngắn
copy()ConditionalFormatRuleBuilderTrả về một chế độ đặt sẵn của trình tạo quy tắc với các chế độ cài đặt của quy tắc này.
getBooleanCondition()BooleanCondition|nullTruy xuất thông tin BooleanCondition của quy tắc nếu quy tắc này sử dụng tiêu chí điều kiện boolean.
getGradientCondition()GradientCondition|nullTruy xuất thông tin GradientCondition của quy tắc, nếu quy tắc này sử dụng tiêu chí điều kiện chuyển màu.
getRanges()Range[]Truy xuất các dải ô mà quy tắc định dạng có điều kiện này được áp dụng.

Tài liệu chi tiết

copy()

Trả về một chế độ đặt sẵn của trình tạo quy tắc với các chế độ cài đặt của quy tắc này.

Cầu thủ trả bóng

ConditionalFormatRuleBuilder – Trình tạo dựa trên các chế độ cài đặt của quy tắc này.


getBooleanCondition()

Truy xuất thông tin BooleanCondition của quy tắc nếu quy tắc này sử dụng tiêu chí điều kiện boolean. Nếu không, hàm này sẽ trả về null. Điều kiện Boolean chứa các chế độ cài đặt định dạng như độ đậm của phông chữ, màu phông chữ và màu nền.

// Log the boolean criteria type of the first conditional format rules of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

Cầu thủ trả bóng

BooleanCondition|null – Đối tượng điều kiện boolean hoặc null nếu quy tắc không sử dụng điều kiện boolean.


getGradientCondition()

Truy xuất thông tin GradientCondition của quy tắc, nếu quy tắc này sử dụng tiêu chí điều kiện chuyển màu. Nếu không, hàm này sẽ trả về null.

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

Cầu thủ trả bóng

GradientCondition|null – Đối tượng điều kiện chuyển màu hoặc null nếu quy tắc không sử dụng điều kiện chuyển màu.


getRanges()

Truy xuất các dải ô mà quy tắc định dạng có điều kiện này được áp dụng.

// Log each range of the first conditional format rule of a sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

Cầu thủ trả bóng

Range[] – Các dải ô mà quy tắc định dạng có điều kiện này được áp dụng.