Class ConditionalFormatRuleBuilder

ConditionalRuleRuleBuilder

أداة إنشاء قواعد التنسيق الشرطي.

// 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إنشاء قاعدة تنسيق شرطي من الإعدادات المُطبّقة على أداة الإنشاء.
copy()ConditionalFormatRuleBuilderلعرض إعدادات مسبقة لإنشاء القواعد باستخدام إعدادات هذه القاعدة.
getBooleanCondition()BooleanConditionلاسترداد معلومات BooleanCondition القاعدة إذا كانت هذه القاعدة تستخدم معايير شرطية منطقية.
getGradientCondition()GradientConditionلاسترداد معلومات GradientCondition\u30s، في حال كانت هذه القاعدة تستخدم معايير شرط التدرج.
getRanges()Range[]لاسترداد النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.
setBackground(color)ConditionalFormatRuleBuilderلضبط لون الخلفية لتنسيق التنسيق الشرطي.
setBackgroundObject(color)ConditionalFormatRuleBuilderلضبط لون الخلفية لتنسيق التنسيق الشرطي.
setBold(bold)ConditionalFormatRuleBuilderلضبط النص بالخط الغامق لتنسيق قاعدة الشرط الشرطية.
setFontColor(color)ConditionalFormatRuleBuilderلضبط لون الخط لتنسيق التنسيق الشرطي's.
setFontColorObject(color)ConditionalFormatRuleBuilderلضبط لون الخط لتنسيق التنسيق الشرطي's.
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لضبط الخط المائل لنص التنسيق الشرطي's.
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()

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

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

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


copy()

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

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

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


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


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

المعلّمات

الاسمالنوعالوصف
colorStringاللون المطلوب أو null المطلوب محوه.

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

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


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

المعلّمات

الاسمالنوعالوصف
colorColorكائن اللون المطلوب أو null المطلوب محوه.

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

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


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

المعلّمات

الاسمالنوعالوصف
boldBooleanلتحديد ما إذا كان يجب عرض النص بالخط الغامق أم لا في حال استيفاء شرط التنسيق. يزيل null هذا الإعداد.

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

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


setFontColor(color)

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

المعلّمات

الاسمالنوعالوصف
colorStringاللون المطلوب أو null المطلوب محوه.

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

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


setFontColorObject(color)

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

المعلّمات

الاسمالنوعالوصف
colorColorكائن اللون المطلوب أو null المطلوب محوه.

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

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


setGradientMaxpoint(color)

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

المعلّمات

الاسمالنوعالوصف
colorStringلون الحد الأقصى الذي يجب ضبطه.

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

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


setGradientMaxpointObject(color)

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

المعلّمات

الاسمالنوعالوصف
colorColorعنصر لون الحد الأقصى المراد إعداده.

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

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


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

المعلّمات

الاسمالنوعالوصف
colorColorلون الحد الأقصى الذي يجب ضبطه.
typeInterpolationTypeتمثّل هذه الخاصية نوع إقحام الحد الأقصى المطلوب ضبطه.
valueStringتمثّل هذه السمة القيمة القصوى التي يجب ضبطها.

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

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


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

المعلّمات

الاسمالنوعالوصف
colorStringلون الحد الأقصى الذي يجب ضبطه.
typeInterpolationTypeتمثّل هذه الخاصية نوع إقحام الحد الأقصى المطلوب ضبطه.
valueStringتمثّل هذه السمة القيمة القصوى التي يجب ضبطها.

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

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


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

المعلّمات

الاسمالنوعالوصف
colorColorلون نقطة المنتصف المراد ضبطها.
typeInterpolationTypeنوع إقحام نقطة النهاية المراد ضبطها أو null لمحوه.
valueStringتمثّل هذه السمة قيمة نقطة المنتصف.

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

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


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

المعلّمات

الاسمالنوعالوصف
colorStringلون نقطة المنتصف المراد ضبطها.
typeInterpolationTypeنوع إقحام نقطة النهاية المراد ضبطها أو null لمحوه.
valueStringتمثّل هذه السمة قيمة نقطة المنتصف.

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

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


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

المعلّمات

الاسمالنوعالوصف
colorStringلون النقطة الأدنى المطلوب ضبطها

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

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


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

المعلّمات

الاسمالنوعالوصف
colorColorعنصر لون النقطة الأدنى المطلوب ضبطه.

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

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


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

المعلّمات

الاسمالنوعالوصف
colorColorلون النقطة الأدنى المطلوب ضبطها
typeInterpolationTypeنوع إضافة الحد الأدنى المطلوب لضبطه.
valueStringتمثّل هذه الخاصية قيمة الحد الأدنى المطلوب ضبطها.

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

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


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

المعلّمات

الاسمالنوعالوصف
colorStringلون النقطة الأدنى المطلوب ضبطها
typeInterpolationTypeنوع إضافة الحد الأدنى المطلوب لضبطه.
valueStringتمثّل هذه الخاصية قيمة الحد الأدنى المطلوب ضبطها.

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

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


setItalic(italic)

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

المعلّمات

الاسمالنوعالوصف
italicBooleanلتحديد ما إذا كان يجب أن يكون النص مائلاً في حال استيفاء شرط التنسيق أم لا. يزيل null هذا الإعداد.

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

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


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

المعلّمات

الاسمالنوعالوصف
rangesRange[]النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.

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

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


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

المعلّمات

الاسمالنوعالوصف
strikethroughBooleanتبيّن أنّ النص يجب أن يتوسطه خط في حال استيفاء شرط التنسيق، لأنّ null يزيل هذا الإعداد.

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

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


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

المعلّمات

الاسمالنوعالوصف
underlineBooleanلتحديد ما إذا كان يجب تسطير النص في حال استيفاء شرط التنسيق أم لا، يزيل null هذا الإعداد.

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

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


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


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


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

المعلّمات

الاسمالنوعالوصف
dateDateالتاريخ الأخير

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

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


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

المعلّمات

الاسمالنوعالوصف
dateRelativeDateأحدث تاريخ بالنسبة إلى نوع التاريخ المحدّد

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

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


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

المعلّمات

الاسمالنوعالوصف
dateDateأقرب تاريخ غير مقبول

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

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


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

المعلّمات

الاسمالنوعالوصف
dateRelativeDateأحدث تاريخ بالنسبة إلى نوع التاريخ المحدّد

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

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


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

المعلّمات

الاسمالنوعالوصف
dateDateالتاريخ الوحيد المقبول

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

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


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

المعلّمات

الاسمالنوعالوصف
dateRelativeDateأحدث تاريخ بالنسبة إلى نوع التاريخ المحدّد

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

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


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

المعلّمات

الاسمالنوعالوصف
formulaStringصيغة مخصّصة يتم تقييمها على true إذا كان الإدخال صالحًا.

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

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


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

المعلّمات

الاسمالنوعالوصف
startNumberتمثّل هذه السمة أدنى قيمة مقبولة.
endNumberأعلى قيمة مقبولة.

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

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


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

المعلّمات

الاسمالنوعالوصف
numberNumberالقيمة الوحيدة المقبولة.

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

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


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

المعلّمات

الاسمالنوعالوصف
numberNumberأعلى قيمة غير مقبولة.

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

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


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

المعلّمات

الاسمالنوعالوصف
numberNumberتمثّل هذه السمة أدنى قيمة مقبولة.

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

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


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

المعلّمات

الاسمالنوعالوصف
numberNumberأدنى قيمة غير مقبولة.

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

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


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

المعلّمات

الاسمالنوعالوصف
numberNumberأعلى قيمة مقبولة.

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

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


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

المعلّمات

الاسمالنوعالوصف
startNumberأدنى قيمة غير مقبولة.
endNumberأعلى قيمة غير مقبولة.

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

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


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

المعلّمات

الاسمالنوعالوصف
numberNumberالقيمة الوحيدة غير المقبولة.

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

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


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

المعلّمات

الاسمالنوعالوصف
textStringالقيمة التي يجب أن يحتوي عليها الإدخال.

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

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


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

المعلّمات

الاسمالنوعالوصف
textStringالقيمة التي يجب ألا يحتوي عليها الإدخال

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

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


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

المعلّمات

الاسمالنوعالوصف
textStringالنص المطلوب مقارنته بنهاية السلسلة.

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

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


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

المعلّمات

الاسمالنوعالوصف
textStringالقيمة الوحيدة المقبولة.

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

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


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

المعلّمات

الاسمالنوعالوصف
textStringالنص المطلوب مقارنته ببداية السلسلة.

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

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


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

المعلّمات

الاسمالنوعالوصف
criteriaBooleanCriteriaنوع معايير التنسيق الشرطي.
argsObject[]مصفوفة من الوسيطات المناسبة لنوع المعايير، وعدد الوسيطات ونوعها يتطابق مع طريقة when...() المقابلة أعلاه.

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

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