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.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
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 – כלי build שמבוסס על ההגדרות של הכלל הזה

---

getBooleanCondition()

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

// Log the boolean criteria type of the first conditional format rules of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var 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.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var ranges = rule.getRanges();
for (var 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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".

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

פרמטרים

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

חזרה

ConditionalFormatRuleBuilder – ה-builder, לשרשורים.

---

setBold(bold)

הגדרה של הדגשת טקסט בהתאם לפורמט של הכלל של העיצוב המותנה. אם הערך של bold הוא true, הכלל ידגיש טקסט אם התנאי מתקיים; אם 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBold(true)
    .setRanges([range])
    .build();
var 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor("#FF0000")
    .setRanges([range])
    .build();
var 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setFontColor(color)
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var 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.

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

פרמטרים

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

חזרה

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.

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

פרמטרים

שם	סוג	תיאור
color	Color	צבע הנקודה המקסימלית שיש להגדיר.
type	InterpolationType	סוג האינטרפולציה של הנקודה המקסימלית שצריך להגדיר.
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.

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

פרמטרים

שם	סוג	תיאור
color	String	צבע הנקודה המקסימלית שיש להגדיר.
type	InterpolationType	סוג האינטרפולציה של הנקודה המקסימלית שצריך להגדיר.
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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint("#FF0000")
    .setGradientMinpoint("#FFFFFF")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var textColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT)
    .build();
var backgroundColor = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpoint(textColor)
    .setGradientMinpoint(backgroundColor)
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var color1 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1)
    .build();
var color2 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2)
    .build();
var color3 = SpreadsheetApp.newColor()
    .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3)
    .build();
var rule = SpreadsheetApp.newConditionalFormatRule()
    .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100")
    .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50")
    .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0")
    .setRanges([range])
    .build();
var 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.

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

פרמטרים

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

חזרה

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

---

setItalic(italic)

הגדרת טקסט נטוי בהתאם לפורמט של הכלל של העיצוב המותנה. אם הערך של italic הוא true, הכלל יהפוך לנטוי טקסט אם התנאי מתקיים. אם 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setItalic(true)
    .setRanges([range])
    .build();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var rangeOne = sheet.getRange("A1:B3");
var rangeTwo = sheet.getRange("D4:F6");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([rangeOne, rangeTwo])
    .build();
var rules = sheet.getConditionalFormatRules();
rules.push(rule);
sheet.setConditionalFormatRules(rules);

פרמטרים

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

חזרה

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

---

setStrikethrough(strikethrough)

מגדיר קו חוצה לטקסט עבור הפורמט של הכלל של העיצוב המותנה. אם strikethrough הוא true, הטקסט שיופיע עם קו חוצה על הכלל, אם התנאי מתקיים; אם 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".

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

פרמטרים

שם	סוג	תיאור
strikethrough	Boolean	האם צריך להוסיף קו חוצה בטקסט אם תנאי הפורמט הוא met; ההגדרה הזו תוסר על ידי 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setUnderline(true)
    .setRanges([range])
    .build();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.
var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenCellNotEmpty()
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(new Date("11/4/1993"))
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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)".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenFormulaSatisfied("=EQ(B4, C3)")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberGreaterThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThan(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberLessThanOrEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotBetween(1, 10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenNumberNotEqualTo(10)
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextContains("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextDoesNotContain("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEndsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextEqualTo("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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".

var sheet = SpreadsheetApp.getActiveSheet();
var range = sheet.getRange("A1:B3");
var rule = SpreadsheetApp.newConditionalFormatRule()
    .whenTextStartsWith("hello")
    .setBackground("#FF0000")
    .setRanges([range])
    .build();
var 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.

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

פרמטרים

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

חזרה

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