דף זה תורגם על ידי Cloud Translation API.

Class ConditionalFormatRule

גישה לכללי עיצוב מותנה. כדי ליצור כלל חדש, יש להשתמש ב-SpreadsheetApp.newConditionalFormatRule() וב-ConditionalFormatRuleBuilder. אפשר להשתמש ב-Sheet.setConditionalFormatRules(rules) כדי להגדיר את הכללים של גיליון נתון.

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
`copy()`	`ConditionalFormatRuleBuilder`	מחזירה הגדרה קבועה מראש של יוצר הכללים עם ההגדרות של כלל זה.
`getBooleanCondition()`	`BooleanCondition`	אחזור של פרטי `BooleanCondition` של הכלל אם הוא משתמש בקריטריונים של תנאי בוליאני.
`getGradientCondition()`	`GradientCondition`	מאחזרת את פרטי `GradientCondition` של הכלל, אם הכלל הזה משתמש בקריטריונים של תנאי הדרגתי.
`getRanges()`	`Range[]`	מאחזרת את הטווחים שעליהם חל כלל העיצוב המותנה הזה.

תיעוד מפורט

`copy()`

מחזירה הגדרה קבועה מראש של יוצר הכללים עם ההגדרות של כלל זה.

החזרות

ConditionalFormatRuleBuilder – כלי המבוסס על ההגדרות של הכלל הזה

`getBooleanCondition()`

אחזור של פרטי BooleanCondition של הכלל אם הוא משתמש בקריטריונים של תנאי בוליאני. אחרת, הפונקציה מחזירה את הערך null.

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

החזרות

BooleanCondition - אובייקט התנאי הבוליאני, או null אם הכלל לא משתמש בתנאי בוליאני.

`getGradientCondition()`

מאחזרת את פרטי GradientCondition של הכלל, אם הכלל הזה משתמש בקריטריונים של תנאי הדרגתי. אחרת, הפונקציה מחזירה את הערך null.

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

החזרות

GradientCondition – אובייקט התנאי של ההדרגתיות, או null אם הכלל לא משתמש בתנאי הדרגתי.

`getRanges()`

מאחזרת את הטווחים שעליהם חל כלל העיצוב המותנה הזה.

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

החזרות

Range[] - הטווחים שעליהם חל הכלל של הפורמט המותנה.