Class ConditionalFormatRule

ConditionalFormatRule

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

כדי לגשת להגדרות העיצוב של כללים שמשתמשים בקריטריונים של תנאים בוליאניים, צריך לקרוא ל-getBooleanCondition() ולהשתמש בשיטות באובייקט BooleanCondition שמוחזר.

Methods

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

תיעוד מפורט

copy()

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

חזרה

‫ConditionalFormatRuleBuilder – builder שמבוסס על ההגדרות של הכלל הזה.

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