Class ConditionalFormatRule

ConditionalFormatRule

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

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
copy()	ConditionalFormatRuleBuilder	הפונקציה מחזירה הגדרה מוגדרת מראש של הכלי ליצירת כללים עם ההגדרות של הכלל הזה.
getBooleanCondition()	BooleanCondition	הפונקציה מאחזרת את המידע של BooleanCondition של הכלל, אם הכלל הזה משתמש בקריטריונים של תנאי בוליאני.
getGradientCondition()	GradientCondition	הפונקציה מאחזרת את המידע של 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 אם הכלל לא משתמש בתנאי בוליאני.

---

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