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