Class ConditionalFormatRule

Quy tắcĐịnh dạngcó điều kiện

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

Phương thức

Phương thứcLoại dữ liệu trả vềMô tả ngắn
copy()ConditionalFormatRuleBuilderTrả về một giá trị đặt trước của trình tạo quy tắc với chế độ cài đặt của quy tắc này.
getBooleanCondition()BooleanConditionTruy 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()GradientConditionTruy 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 giá trị đặt trước của trình tạo quy tắc với chế độ cài đặt của quy tắc này.

Cầu thủ trả bóng

ConditionalFormatRuleBuilder – một trình tạo dựa trên 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, trả về null. 

// 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 – đố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, 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 – Đố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.