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