Class ConditionalFormatRule

ConditionalFormatRule

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

Methods

שיטהסוג הערך שמוחזרתיאור קצר
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.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const 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.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const 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.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

חזרה

‫Range[] – הטווחים שעליהם חל כלל העיצוב המותנה הזה.