Class ConditionalFormatRuleBuilder

إنشاء قاعدة تنسيق شرطي من الإعدادات المُطبّقة على أداة الإنشاء.

تذكرة ذهاب وعودة

ConditionalFormatRule: تمثيل لقاعدة التنسيق الشرطي

لعرض إعدادات مسبقة لإنشاء القواعد باستخدام إعدادات هذه القاعدة.

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder - أداة إنشاء استنادًا إلى إعدادات هذه القاعدة

لاسترداد معلومات 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 إذا لم تستخدم القاعدة شرطًا منطقيًا.

لاسترداد معلومات GradientCondition\u30s، في حال كانت هذه القاعدة تستخدم معايير شرط التدرج. بخلاف ذلك، يتم إرجاع 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 إذا لم تستخدم القاعدة شرطًا.

لاسترداد النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.

// 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[] - النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.

لضبط لون الخلفية لتنسيق التنسيق الشرطي. يؤدي تمرير 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط لون الخلفية لتنسيق التنسيق الشرطي. يؤدي تمرير 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل.

لضبط النص بالخط الغامق لتنسيق قاعدة الشرط الشرطية. وإذا كان 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط لون الخط لتنسيق التنسيق الشرطي's. يؤدي تمرير 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط لون الخط لتنسيق التنسيق الشرطي's. يؤدي تمرير 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل.

يؤدي هذا الإعداد إلى محو قيمة الحد الأقصى للمقياس المتدرّج للقواعد، ويستخدم بدلاً من ذلك الحد الأقصى للقيمة في نطاقات القاعدة. يعمل أيضًا على ضبط لون الحد الأقصى للتدرّج&#39، على لون الإدخال.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

يؤدي هذا الإعداد إلى محو قيمة الحد الأقصى للمقياس المتدرّج للقواعد، ويستخدم بدلاً من ذلك الحد الأقصى للقيمة في نطاقات القاعدة. يعمل أيضًا على ضبط لون الحد الأقصى للتدرّج&#39، على لون الإدخال.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل.

تضبط هذه السياسة حقول الحد الأقصى للتدرج المتدرج.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل.

تضبط هذه السياسة حقول الحد الأقصى للتدرج المتدرج.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط حقول نقطةالشرط المتدرّجة في قاعدة الشرط المشروطة. يمحو كل حقول نقطة النهاية إذا كان نوع التمرير في الحقل الخاص بالاستخلاص هو 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل.

لضبط حقول نقطةالشرط المتدرّجة في قاعدة الشرط المشروطة. يمحو كل حقول نقطة النهاية إذا كان نوع التمرير في الحقل الخاص بالاستخلاص هو 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

يؤدي ذلك إلى محو قيمة النقطة الحدية للقواعد الشرطية، ويستخدم بدلاً من ذلك الحد الأدنى من القيمة في نطاقات القاعدة. يؤدي هذا الخيار أيضًا إلى ضبط لون نقطة الحد الأدنى "التدرّج" على لون الإدخال.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

يؤدي ذلك إلى محو قيمة النقطة الحدية للقواعد الشرطية، ويستخدم بدلاً من ذلك الحد الأدنى من القيمة في نطاقات القاعدة. يؤدي هذا الخيار أيضًا إلى ضبط لون نقطة الحد الأدنى "التدرّج" على لون الإدخال.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل.

لضبط حقول النقطة الحدية للتدرّج قاعدة الشرط الشرطية.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل.

لضبط حقول النقطة الحدية للتدرّج قاعدة الشرط الشرطية.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط الخط المائل لنص التنسيق الشرطي's. إذا كان 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

تحدد نطاقًا واحدًا أو أكثر يتم تطبيق قاعدة التنسيق الشرطي عليه. تحل هذه العملية تحل محل أي نطاقات حالية. ويؤدي ضبط مصفوفة فارغة إلى محو أي نطاقات حالية. يجب أن تحتوي القاعدة على نطاق واحد على الأقل.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط خط يتوسطه النص لتنسيق القاعدة الشرطية. إذا كان 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لتحديد النص الذي تحته تنسيق التنسيق الشرطي للقواعد. إذا كان 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما تكون الخلية فارغة.

// 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 — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي ليتم تشغيلها عندما لا تكون الخلية فارغة.

// 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 — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ بعد القيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ بعد التاريخ النسبي المحدد.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ قبل التاريخ المحدد.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ قبل التاريخ النسبي المحدد.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ مساويًا لتاريخ معين.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ مساويًا للتاريخ النسبي.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند تقييم الصيغة المحددة على 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);

المعلّمات

تذكرة ذهاب وعودة

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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون أحد الأرقام مساويًا للقيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون أحد الأرقام أكبر من القيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون أحد الأرقام أكبر من أو يساوي القيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

تتيح هذه السياسة ضبط قاعدة التنسيق الشرطي المشروط ليتم تشغيلها عندما يكون الرقم أقل من القيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون الرقم أقل من أو يساوي القيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

تعمل هذه السياسة على ضبط قاعدة التنسيق الشرطي لكي يتم تشغيلها عند عدم وجود رقم بين قيمتين محدّدتين، وليس أيًا منهما.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما لا يكون أحد الأرقام مساويًا للقيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يحتوي الإدخال على القيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما لا يحتوي الإدخال على القيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند انتهاء الإدخال بالقيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون الإدخال مساويًا للقيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند بدء الإدخال بالقيمة المحددة.

// 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل

لضبط قاعدة التنسيق الشرطي على المعايير التي تحددها قيم 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);

المعلّمات

تذكرة ذهاب وعودة

ConditionalFormatRuleBuilder — أداة الإنشاء للسلاسل