Class ConditionalFormatRuleBuilder

ConditionalFormatRuleBuilder

כלי ליצירת כללים של עיצוב מותנה.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number between 1 and 10.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
build()	ConditionalFormatRule	יצירת כלל של עיצוב מותנה מההגדרות שחלות על ה-builder.
copy()	ConditionalFormatRuleBuilder	הפונקציה מחזירה הגדרה מוגדרת מראש של הכלי ליצירת כללים עם ההגדרות של הכלל הזה.
getBooleanCondition()	BooleanCondition	הפונקציה מאחזרת את המידע של BooleanCondition של הכלל, אם הכלל הזה משתמש בקריטריונים של תנאי בוליאני.
getGradientCondition()	GradientCondition	הפונקציה מאחזרת את המידע של GradientCondition של הכלל, אם הכלל הזה משתמש בקריטריונים של תנאי שיפוע.
getRanges()	Range[]	הפונקציה מאחזרת את טווחי התאים שעליהם חל הכלל הזה של העיצוב המותנה.
setBackground(color)	ConditionalFormatRuleBuilder	מגדיר את צבע הרקע של העיצוב של כלל העיצוב המותנה.
setBackgroundObject(color)	ConditionalFormatRuleBuilder	מגדיר את צבע הרקע של העיצוב של כלל העיצוב המותנה.
setBold(bold)	ConditionalFormatRuleBuilder	הגדרת טקסט מודגש לפורמט של כלל העיצוב המותנה.
setFontColor(color)	ConditionalFormatRuleBuilder	הגדרת צבע הגופן של הפורמט של כלל העיצוב המותנה.
setFontColorObject(color)	ConditionalFormatRuleBuilder	הגדרת צבע הגופן של הפורמט של כלל העיצוב המותנה.
setGradientMaxpoint(color)	ConditionalFormatRuleBuilder	הפונקציה מנקה את הערך של נקודת המקסימום של שיפוע כלל העיצוב המותנה, ובמקום זאת משתמשת בערך המקסימלי בטווחים של הכלל.
setGradientMaxpointObject(color)	ConditionalFormatRuleBuilder	הפונקציה מנקה את הערך של נקודת המקסימום של שיפוע כלל העיצוב המותנה, ובמקום זאת משתמשת בערך המקסימלי בטווחים של הכלל.
setGradientMaxpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	הגדרת השדות של נקודת השיא של שיפוע בכלל העיצוב המותנה.
setGradientMaxpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	הגדרת השדות של נקודת השיא של שיפוע בכלל העיצוב המותנה.
setGradientMidpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	הגדרת שדות נקודת האמצע של שיפוע הכלל של העיצוב המותנה.
setGradientMidpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	הגדרת שדות נקודת האמצע של שיפוע הכלל של העיצוב המותנה.
setGradientMinpoint(color)	ConditionalFormatRuleBuilder	הפונקציה מנקה את ערך נקודת המינימום של שיפוע כלל העיצוב המותנה, ובמקום זאת משתמשת בערך המינימום בטווחים של הכלל.
setGradientMinpointObject(color)	ConditionalFormatRuleBuilder	הפונקציה מנקה את ערך נקודת המינימום של שיפוע כלל העיצוב המותנה, ובמקום זאת משתמשת בערך המינימום בטווחים של הכלל.
setGradientMinpointObjectWithValue(color, type, value)	ConditionalFormatRuleBuilder	הגדרת שדות הנקודה המינימלית של שיפוע הכלל של העיצוב המותנה.
setGradientMinpointWithValue(color, type, value)	ConditionalFormatRuleBuilder	הגדרת שדות הנקודה המינימלית של שיפוע הכלל של העיצוב המותנה.
setItalic(italic)	ConditionalFormatRuleBuilder	מגדיר טקסט נטוי בפורמט של כלל העיצוב המותנה.
setRanges(ranges)	ConditionalFormatRuleBuilder	הגדרת טווח אחד או יותר שעליו חל הכלל הזה של עיצוב מותנה.
setStrikethrough(strikethrough)	ConditionalFormatRuleBuilder	הגדרת קו חוצה בטקסט של הפורמט של כלל העיצוב המותנה.
setUnderline(underline)	ConditionalFormatRuleBuilder	הגדרת קו תחתון לטקסט של העיצוב של כלל העיצוב המותנה.
whenCellEmpty()	ConditionalFormatRuleBuilder	הגדרת כלל העיצוב המותנה כך שיופעל כשהתא ריק.
whenCellNotEmpty()	ConditionalFormatRuleBuilder	הגדרת הכלל של העיצוב המותנה כך שיופעל כשהתא לא ריק.
whenDateAfter(date)	ConditionalFormatRuleBuilder	מגדיר את כלל העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה אחרי הערך שצוין.
whenDateAfter(date)	ConditionalFormatRuleBuilder	הגדרת הכלל של העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה אחרי התאריך היחסי שצוין.
whenDateBefore(date)	ConditionalFormatRuleBuilder	מגדירים את כלל העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה לפני התאריך שצוין.
whenDateBefore(date)	ConditionalFormatRuleBuilder	הגדרת הכלל של העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה לפני התאריך היחסי הנתון.
whenDateEqualTo(date)	ConditionalFormatRuleBuilder	מגדיר את כלל העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה שווה לתאריך שצוין.
whenDateEqualTo(date)	ConditionalFormatRuleBuilder	מגדיר את כלל העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה שווה לתאריך היחסי שצוין.
whenFormulaSatisfied(formula)	ConditionalFormatRuleBuilder	הכלל מגדיר שהפורמט המותנה יופעל כשהנוסחה נתונה תהיה שווה ל-true.
whenNumberBetween(start, end)	ConditionalFormatRuleBuilder	מגדיר את כלל הפורמט המותנה כך שיופעל כשהמספר נמצא בין שני ערכים שצוינו, או שהוא אחד משני הערכים האלה.
whenNumberEqualTo(number)	ConditionalFormatRuleBuilder	מגדיר את הכלל של העיצוב המותנה כך שיופעל כאשר מספר שווה לערך הנתון.
whenNumberGreaterThan(number)	ConditionalFormatRuleBuilder	מגדיר את כלל הפורמט המותנה כך שיופעל כשהמספר גדול מהערך שצוין.
whenNumberGreaterThanOrEqualTo(number)	ConditionalFormatRuleBuilder	מגדיר את כלל העיצוב המותנה כך שיופעל כשהמספר גדול מהערך הנתון או שווה לו.
whenNumberLessThan(number)	ConditionalFormatRuleBuilder	הגדרת הכלל של העיצוב המותנה כך שיופעל כשהמספר קטן מהערך הנתון.
whenNumberLessThanOrEqualTo(number)	ConditionalFormatRuleBuilder	מגדיר את הכלל של העיצוב המותנה כך שיופעל כשהמספר קטן מהערך הנתון או שווה לו.
whenNumberNotBetween(start, end)	ConditionalFormatRuleBuilder	מגדיר את כלל הפורמט המותנה כך שיופעל כשהמספר לא נמצא בין שני ערכים שצוינו, ולא שווה לאף אחד מהם.
whenNumberNotEqualTo(number)	ConditionalFormatRuleBuilder	מגדיר את הכלל של העיצוב המותנה כך שיופעל כאשר מספר לא שווה לערך הנתון.
whenTextContains(text)	ConditionalFormatRuleBuilder	הגדרת הכלל של העיצוב המותנה כך שיופעל כאשר הקלט מכיל את הערך הנתון.
whenTextDoesNotContain(text)	ConditionalFormatRuleBuilder	מגדיר את הכלל של העיצוב המותנה כך שיופעל כשהקלט לא מכיל את הערך הנתון.
whenTextEndsWith(text)	ConditionalFormatRuleBuilder	הגדרת כלל העיצוב המותנה כך שיופעל כשהקלט מסתיים בערך הנתון.
whenTextEqualTo(text)	ConditionalFormatRuleBuilder	הגדרת הכלל של העיצוב המותנה כך שיופעל כאשר הקלט שווה לערך שצוין.
whenTextStartsWith(text)	ConditionalFormatRuleBuilder	מגדיר את כלל העיצוב המותנה כך שיופעל כשהקלט מתחיל בערך הנתון.
withCriteria(criteria, args)	ConditionalFormatRuleBuilder	מגדיר את כלל הפורמט המותנה לפי קריטריונים שמוגדרים על ידי ערכים של BooleanCriteria, בדרך כלל מ-criteria ו-arguments של כלל קיים.

מסמכים מפורטים

build()

יצירת כלל של עיצוב מותנה מההגדרות שחלות על ה-builder.

חזרה

ConditionalFormatRule – ייצוג של כלל העיצוב המותנה

---

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

---

setBackground(color)

מגדיר את צבע הרקע של העיצוב של כלל העיצוב המותנה. העברת הערך null מסירה מהכלל את הגדרת הפורמט של צבע הרקע.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color to red if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	String	הצבע הרצוי או null כדי לנקות.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setBackgroundObject(color)

מגדיר את צבע הרקע של העיצוב של כלל העיצוב המותנה. העברת הערך null מסירה מהכלל את הגדרת הפורמט של צבע הרקע.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color to theme background color if the cell has text
// equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
                  .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground(color)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	Color	את אובייקט הצבע הרצוי או null כדי לנקות.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לצורך קישור.

---

setBold(bold)

הגדרת טקסט מודגש לפורמט של כלל העיצוב המותנה. אם הערך של bold הוא true, הכלל מודגש את הטקסט אם התנאי מתקיים. אם הערך של bold הוא false, הכלל מסיר את ההדגשה הקיימת אם התנאי מתקיים. העברת הערך null מסירה מהכלל את ההגדרה של הפורמט המודגש.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn their text bold if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBold(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
bold	Boolean	האם הטקסט יודגש אם התנאי של הפורמט מתקיים. הערך null מסיר את ההגדרה הזו.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setFontColor(color)

הגדרת צבע הגופן של הפורמט של כלל העיצוב המותנה. העברת הערך null מסירה מהכלל את ההגדרה של פורמט צבע הגופן.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their font color to red if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setFontColor('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	String	הצבע הרצוי או null כדי לנקות.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setFontColorObject(color)

הגדרת צבע הגופן של הפורמט של כלל העיצוב המותנה. העברת הערך null מסירה מהכלל את ההגדרה של פורמט צבע הגופן.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their font color to theme text color if the cell has text equal to
// "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color = SpreadsheetApp.newColor()
                  .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                  .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setFontColor(color)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	Color	את אובייקט הצבע הרצוי או null כדי לנקות.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לצורך קישור.

---

setGradientMaxpoint(color)

הפונקציה מנקה את הערך של נקודת המקסימום של שיפוע כלל העיצוב המותנה, ובמקום זאת משתמשת בערך המקסימלי בטווחים של הכלל. הפונקציה גם מגדירה את צבע הנקודה המקסימלית של העקומה לצבעים שהוזנו.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between white and red, based on their
// values in comparison to the ranges minimum and maximum values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint('#FF0000')
                 .setGradientMinpoint('#FFFFFF')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	String	הצבע של הנקודה המקסימלית להגדרה.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setGradientMaxpointObject(color)

הפונקציה מנקה את הערך של נקודת המקסימום של שיפוע כלל העיצוב המותנה, ובמקום זאת משתמשת בערך המקסימלי בטווחים של הכלל. הפונקציה גם מגדירה את צבע הנקודה המקסימלית של העקומה לצבעים שהוזנו.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between theme text and background
// colors, based on their values in comparison to the ranges minimum and maximum
// values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const textColor = SpreadsheetApp.newColor()
                      .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                      .build();
const backgroundColor =
    SpreadsheetApp.newColor()
        .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
        .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint(textColor)
                 .setGradientMinpoint(backgroundColor)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	Color	אובייקט הצבע של הנקודה המקסימלית שרוצים להגדיר.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לצורך קישור.

---

setGradientMaxpointObjectWithValue(color, type, value)

הגדרת השדות של נקודת השיא של שיפוע בכלל העיצוב המותנה.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from theme accent 1, accent 2 to accent
// 3 colors, based on their values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	Color	הצבע של הנקודה המקסימלית להגדרה.
type	InterpolationType	סוג הביניים של maxpoint להגדרה.
value	String	הערך של הנקודה המקסימלית להגדרה.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לצורך קישור.

---

setGradientMaxpointWithValue(color, type, value)

הגדרת השדות של נקודת השיא של שיפוע בכלל העיצוב המותנה.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from red green to blue, based on their
// values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	String	הצבע של הנקודה המקסימלית להגדרה.
type	InterpolationType	סוג הביניים של maxpoint להגדרה.
value	String	הערך של הנקודה המקסימלית להגדרה.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setGradientMidpointObjectWithValue(color, type, value)

הגדרת שדות נקודת האמצע של שיפוע הכלל של העיצוב המותנה. ניקוי כל שדות הנקודות האמצעיות אם סוג הבינוי שהוענק הוא null.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from theme accent 1 to accent 2 to
// accent 3 colors, based on their values in comparison to the values 0, 50, and
// 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	Color	צבע נקודת האמצע שרוצים להגדיר.
type	InterpolationType	סוג הביניים של האינטרפולציה שרוצים להגדיר או null כדי לנקות.
value	String	הערך של נקודת האמצע להגדרה.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לצורך קישור.

---

setGradientMidpointWithValue(color, type, value)

הגדרת שדות נקודת האמצע של שיפוע הכלל של העיצוב המותנה. ניקוי כל שדות הנקודות האמצעיות אם סוג הבינוי שהוענק הוא null.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from red green to blue, based on their
// values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	String	צבע נקודת האמצע שרוצים להגדיר.
type	InterpolationType	סוג הביניים של האינטרפולציה שרוצים להגדיר או null כדי לנקות.
value	String	הערך של נקודת האמצע להגדרה.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setGradientMinpoint(color)

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

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between white and red, based on their
// values in comparison to the ranges minimum and maximum values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint('#FF0000')
                 .setGradientMinpoint('#FFFFFF')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	String	צבע הנקודה המינימלית להגדרה.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setGradientMinpointObject(color)

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

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere between theme text and background
// colors, based on their values in comparison to the ranges minimum and maximum
// values.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const textColor = SpreadsheetApp.newColor()
                      .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
                      .build();
const backgroundColor =
    SpreadsheetApp.newColor()
        .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
        .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpoint(textColor)
                 .setGradientMinpoint(backgroundColor)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	Color	אובייקט הצבע של הנקודה המינימלית שרוצים להגדיר.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לצורך קישור.

---

setGradientMinpointObjectWithValue(color, type, value)

הגדרת שדות הנקודה המינימלית של שיפוע הכלל של העיצוב המותנה.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from theme accent 1 to accent 2 to
// accent 3 colors, based on their values in comparison to the values 0, 50, and
// 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const color1 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
                   .build();
const color2 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
                   .build();
const color3 = SpreadsheetApp.newColor()
                   .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
                   .build();
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     color1,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     color2,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     color3,
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	Color	צבע הנקודה המינימלית להגדרה.
type	InterpolationType	סוג הבינוי של הנקודה המינימלית שרוצים להגדיר.
value	String	הערך של הנקודה המינימלית להגדרה.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לצורך קישור.

---

setGradientMinpointWithValue(color, type, value)

הגדרת שדות הנקודה המינימלית של שיפוע הכלל של העיצוב המותנה.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// set their background color somewhere from red to green to blue, based on
// their values in comparison to the values 0, 50, and 100.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .setGradientMaxpointWithValue(
                     '#0000FF',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '100',
                     )
                 .setGradientMidpointWithValue(
                     '#00FF00',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '50',
                     )
                 .setGradientMinpointWithValue(
                     '#FF0000',
                     SpreadsheetApp.InterpolationType.NUMBER,
                     '0',
                     )
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
color	String	צבע הנקודה המינימלית להגדרה.
type	InterpolationType	סוג הבינוי של הנקודה המינימלית שרוצים להגדיר.
value	String	הערך של הנקודה המינימלית להגדרה.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setItalic(italic)

מגדיר טקסט נטוי בפורמט של כלל העיצוב המותנה. אם הערך של italic הוא true, הכלל גורם לטקסט להופיע בכתב נטוי אם התנאי מתקיים. אם הערך של italic הוא false, הכלל מסיר את הכתב הנטוי הקיים אם התנאי מתקיים. העברת הערך null מסירה מהכלל את ההגדרה של העיצוב הנטוי.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn their text italic if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setItalic(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
italic	Boolean	האם הטקסט יופיע בכתב נטוי אם התנאי של הפורמט יתקיים. הערך null מסיר את ההגדרה הזו.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setRanges(ranges)

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

// Adds a conditional format rule to a sheet that causes cells in range A1:B3
// and range D4:F6 to turn red if they contain a number between 1 and 10.
const sheet = SpreadsheetApp.getActiveSheet();
const rangeOne = sheet.getRange('A1:B3');
const rangeTwo = sheet.getRange('D4:F6');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([rangeOne, rangeTwo])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
ranges	Range[]	טווחי התאים שעליהם חל הכלל הזה של עיצוב מותנה.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setStrikethrough(strikethrough)

הגדרת קו חוצה בטקסט של הפורמט של כלל העיצוב המותנה. אם הערך של strikethrough הוא true, הכלל יגרום לקו חוצה בטקסט אם התנאי מתקיים. אם הערך של false הוא false, הכלל יסיר את כל הפורמטים הקיימים של קו חוצה אם התנאי מתקיים. העברת הערך null מסירה מהכלל את ההגדרה של הפורמט של קו המחיקה.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// strikethrough their text if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setStrikethrough(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
strikethrough	Boolean	האם הטקסט יודגש קו אם התנאי של הפורמט מתקיים. הערך null מסיר את ההגדרה הזו.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

setUnderline(underline)

הגדרת קו תחתון לטקסט של העיצוב של כלל העיצוב המותנה. אם הערך של underline הוא true, הכלל ימתח קו מתחת לטקסט אם התנאי מתקיים. אם הערך של false, הכלל יסיר את הקווים הקיימים מתחת לטקסט אם התנאי מתקיים. העברת הערך null מסירה מהכלל את ההגדרה של העיצוב של קו תחתון.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// underline their text if the cell has text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setUnderline(true)
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
underline	Boolean	אם יש להדגיש את הטקסט אם התנאי של הפורמט מתקיים. הערך null מסיר את ההגדרה הזו.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenCellEmpty()

הגדרת כלל העיצוב המותנה כך שיופעל כשהתא ריק.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they are empty.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenCellEmpty()
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenCellNotEmpty()

הגדרת הכלל של העיצוב המותנה כך שיופעל כשהתא לא ריק.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they are not empty.
const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenCellNotEmpty()
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenDateAfter(date)

מגדיר את כלל העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה אחרי הערך שצוין.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date after 11/4/1993.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateAfter(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
date	Date	התאריך האחרון.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenDateAfter(date)

הגדרת הכלל של העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה אחרי התאריך היחסי שצוין.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date after today.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
date	RelativeDate	התאריך האחרון ביחס לסוג התאריך שנבחר.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenDateBefore(date)

מגדירים את כלל העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה לפני התאריך שצוין.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date before 11/4/1993.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateBefore(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
date	Date	התאריך המוקדם ביותר שאינו קביל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenDateBefore(date)

הגדרת הכלל של העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה לפני התאריך היחסי הנתון.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a date before today.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
date	RelativeDate	התאריך האחרון ביחס לסוג התאריך שנבחר.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenDateEqualTo(date)

מגדיר את כלל העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה שווה לתאריך שצוין.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain the date 11/4/1993.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateEqualTo(new Date('11/4/1993'))
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
date	Date	התאריך היחיד הקביל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenDateEqualTo(date)

מגדיר את כלל העיצוב המותנה כך שיופעל כשתאריך מסוים יהיה שווה לתאריך היחסי שצוין.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain todays date.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
date	RelativeDate	התאריך האחרון ביחס לסוג התאריך שנבחר.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenFormulaSatisfied(formula)

הכלל מגדיר שהפורמט המותנה יופעל כשהנוסחה נתונה תהיה שווה ל-true.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they satisfy the condition "=EQ(B4, C3)".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenFormulaSatisfied('=EQ(B4, C3)')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
formula	String	נוסחה מותאמת אישית שמתקבלת הערך true אם הקלט תקין.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenNumberBetween(start, end)

מגדיר את כלל הפורמט המותנה כך שיופעל כשהמספר נמצא בין שני ערכים שצוינו, או שהוא אחד משני הערכים האלה.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number between 1 and 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
start	Number	הערך הנמוך ביותר הקביל.
end	Number	הערך הגבוה ביותר הקביל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenNumberEqualTo(number)

מגדיר את הכלל של העיצוב המותנה כך שיופעל כאשר מספר שווה לערך הנתון.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain the number 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
number	Number	הערך היחיד הקביל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenNumberGreaterThan(number)

מגדיר את כלל הפורמט המותנה כך שיופעל כשהמספר גדול מהערך שצוין.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number greater than 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberGreaterThan(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
number	Number	הערך הגבוה ביותר שאינו מקובל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenNumberGreaterThanOrEqualTo(number)

מגדיר את כלל העיצוב המותנה כך שיופעל כשהמספר גדול מהערך הנתון או שווה לו.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number greater than or equal to 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberGreaterThanOrEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
number	Number	הערך הנמוך ביותר הקביל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenNumberLessThan(number)

הגדרת הכלל של העיצוב המותנה כך שיופעל כשהמספר קטן מהערך הנתון.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number less than 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberLessThan(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
number	Number	הערך הנמוך ביותר שאינו מקובל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenNumberLessThanOrEqualTo(number)

מגדיר את הכלל של העיצוב המותנה כך שיופעל כשהמספר קטן מהערך הנתון או שווה לו.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number less than or equal to 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberLessThanOrEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
number	Number	הערך הגבוה ביותר הקביל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenNumberNotBetween(start, end)

מגדיר את כלל הפורמט המותנה כך שיופעל כשהמספר לא נמצא בין שני ערכים שצוינו, ולא שווה לאף אחד מהם.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain a number not between 1 and 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberNotBetween(1, 10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
start	Number	הערך הנמוך ביותר שאינו מקובל.
end	Number	הערך הגבוה ביותר שאינו מקובל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenNumberNotEqualTo(number)

מגדיר את הכלל של העיצוב המותנה כך שיופעל כאשר מספר לא שווה לערך הנתון.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they don't contain the number 10.

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenNumberNotEqualTo(10)
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
number	Number	הערך היחיד שאינו מקובל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenTextContains(text)

הגדרת הכלל של העיצוב המותנה כך שיופעל כאשר הקלט מכיל את הערך הנתון.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they contain the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextContains('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
text	String	הערך שהקלט חייב להכיל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenTextDoesNotContain(text)

מגדיר את הכלל של העיצוב המותנה כך שיופעל כשהקלט לא מכיל את הערך הנתון.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they don't contain the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextDoesNotContain('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
text	String	הערך שהקלט לא יכול להכיל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenTextEndsWith(text)

הגדרת כלל העיצוב המותנה כך שיופעל כשהקלט מסתיים בערך הנתון.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they end with the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEndsWith('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
text	String	הטקסט שרוצים להשוות לסוף המחרוזת.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenTextEqualTo(text)

הגדרת הכלל של העיצוב המותנה כך שיופעל כאשר הקלט שווה לערך שצוין.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they have text equal to "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextEqualTo('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
text	String	הערך היחיד הקביל.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

whenTextStartsWith(text)

מגדיר את כלל העיצוב המותנה כך שיופעל כשהקלט מתחיל בערך הנתון.

// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to
// turn red if they start with the text "hello".

const sheet = SpreadsheetApp.getActiveSheet();
const range = sheet.getRange('A1:B3');
const rule = SpreadsheetApp.newConditionalFormatRule()
                 .whenTextStartsWith('hello')
                 .setBackground('#FF0000')
                 .setRanges([range])
                 .build();
const rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
text	String	טקסט להשוואה לתחילת המחרוזת.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור

---

withCriteria(criteria, args)

מגדיר את כלל הפורמט המותנה לפי קריטריונים שמוגדרים על ידי ערכים של BooleanCriteria, בדרך כלל מ-criteria ו-arguments של כלל קיים.

// Adds a new conditional format rule that is a copy of the first active
// conditional format rule, except it instead sets its cells to have a black
// background color.

const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
const booleanCondition = rules[0].getBooleanCondition();
if (booleanCondition != null) {
  const rule = SpreadsheetApp.newConditionalFormatRule()
                   .withCriteria(
                       booleanCondition.getCriteriaType(),
                       booleanCondition.getCriteriaValues(),
                       )
                   .setBackground('#000000')
                   .setRanges(rules[0].getRanges())
                   .build();
  rules.push(rule);
}
sheet.setConditionalFormatRules(rules);

פרמטרים

שם	סוג	תיאור
criteria	BooleanCriteria	סוג הקריטריונים של העיצוב המותנה.
args	Object[]	מערך של ארגומנטים שמתאימים לסוג הקריטריונים. מספר הארגומנטים והסוג שלהם תואמים לשיטה המתאימה של when...() שמפורטת למעלה.

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשור