Class ConditionalFormatRule

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