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

Class ConditionalFormatRule

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

שיטות

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

מסמכי תיעוד מפורטים

`copy()`

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

חזרה

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

`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[] - הטווחים שעליהם חל הכלל של הפורמט המותנה.