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