تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class 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`	تنشئ هذه الدالة قاعدة تنسيق شرطي من الإعدادات المطبَّقة على أداة الإنشاء.
`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()`

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

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`color`	`String`	اللون المطلوب أو `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);

المَعلمات

الاسم	Type	الوصف
`color`	`Color`	كائن اللون المطلوب أو `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);

المَعلمات

الاسم	Type	الوصف
`bold`	`Boolean`	تحديد ما إذا كان يجب عرض النص بخط غامق في حال استيفاء شرط التنسيق، تزيل ميزة `null` هذا الإعداد.

استرجاع الكرة

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

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

المَعلمات

الاسم	Type	الوصف
`color`	`String`	اللون المطلوب أو `null` للمسح.

استرجاع الكرة

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

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

المَعلمات

الاسم	Type	الوصف
`color`	`Color`	كائن اللون المطلوب أو `null` للمحو.

استرجاع الكرة

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

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

المَعلمات

الاسم	Type	الوصف
`color`	`String`	لون الحد الأقصى المطلوب ضبطه

استرجاع الكرة

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

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

المَعلمات

الاسم	Type	الوصف
`color`	`Color`	الحد الأقصى لكائن اللون المطلوب تعيينه.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`color`	`Color`	لون الحد الأقصى المطلوب ضبطه
`type`	`InterpolationType`	نوع الحد الأقصى للاستيفاء المطلوب ضبطه
`value`	`String`	قيمة الحد الأقصى المطلوب ضبطها.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`color`	`String`	لون الحد الأقصى المطلوب ضبطه
`type`	`InterpolationType`	نوع الحد الأقصى للاستيفاء المطلوب ضبطه
`value`	`String`	قيمة الحد الأقصى المطلوب ضبطها.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`color`	`Color`	لون نقطة المنتصف المطلوب ضبطه.
`type`	`InterpolationType`	نوع استكمال نقطة المنتصف المطلوب ضبطه أو `null` للمحو
`value`	`String`	قيمة نقطة المنتصف المطلوب ضبطها.

استرجاع الكرة

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

`setGradientMidpointWithValue(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);

المَعلمات

الاسم	Type	الوصف
`color`	`String`	لون نقطة المنتصف المطلوب ضبطه.
`type`	`InterpolationType`	نوع استكمال نقطة المنتصف المطلوب ضبطه أو `null` للمحو
`value`	`String`	قيمة نقطة المنتصف المطلوب ضبطها.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`color`	`String`	لون النقطة الأدنى المطلوب تعيينه.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`color`	`Color`	كائن لون نقطة minpoint المطلوب تعيينه.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`color`	`Color`	لون النقطة الأدنى المطلوب تعيينه.
`type`	`InterpolationType`	نوع استقراء نقطة النهاية المطلوب تعيينه.
`value`	`String`	قيمة الحدّ الأدنى المطلوب ضبطها.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`color`	`String`	لون النقطة الأدنى المطلوب تعيينه.
`type`	`InterpolationType`	نوع استقراء نقطة النهاية المطلوب تعيينه.
`value`	`String`	قيمة الحدّ الأدنى المطلوب ضبطها.

استرجاع الكرة

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

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

المَعلمات

الاسم	Type	الوصف
`italic`	`Boolean`	للإشارة إلى ما إذا كان يجب أن يكون النص مائلاً في حال استيفاء شرط التنسيق، تزيل ميزة `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);

المَعلمات

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

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`strikethrough`	`Boolean`	ما إذا كان يجب أن يتوسطه النص في حال استيفاء شرط التنسيق، تزيل السمة `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);

المَعلمات

الاسم	Type	الوصف
`underline`	`Boolean`	ما إذا كان يجب وضع خط تحت النص في حال استيفاء شرط التنسيق، تزيل ميزة `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);

المَعلمات

الاسم	Type	الوصف
`date`	`Date`	أحدث تاريخ.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`date`	`RelativeDate`	آخر تاريخ مرتبط بنوع التاريخ المحدّد.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`date`	`Date`	أقرب تاريخ غير مقبول.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`date`	`RelativeDate`	آخر تاريخ مرتبط بنوع التاريخ المحدّد.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`date`	`Date`	التاريخ الوحيد المقبول.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`date`	`RelativeDate`	آخر تاريخ مرتبط بنوع التاريخ المحدّد.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`formula`	`String`	صيغة مخصّصة يتم تقييمها إلى `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);

المَعلمات

الاسم	Type	الوصف
`start`	`Number`	تمثّل هذه السمة أدنى قيمة مقبولة.
`end`	`Number`	تمثّل هذه السمة أعلى قيمة مقبولة.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`number`	`Number`	هذه هي القيمة الوحيدة المقبولة.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`number`	`Number`	القيمة الأعلى غير مقبولة.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`number`	`Number`	تمثّل هذه السمة أدنى قيمة مقبولة.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`number`	`Number`	القيمة الأدنى غير مقبولة.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`number`	`Number`	تمثّل هذه السمة أعلى قيمة مقبولة.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`start`	`Number`	القيمة الأدنى غير مقبولة.
`end`	`Number`	القيمة الأعلى غير مقبولة.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`number`	`Number`	القيمة الوحيدة غير المقبولة.

استرجاع الكرة

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

المَعلمات

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

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`text`	`String`	القيمة التي يجب ألا يحتوي عليها الإدخال.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`text`	`String`	نص لمقارنته بنهاية السلسلة.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`text`	`String`	هذه هي القيمة الوحيدة المقبولة.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`text`	`String`	النص المطلوب مقارنته ببداية السلسلة.

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`criteria`	`BooleanCriteria`	تمثّل هذه السمة نوع معايير التنسيق الشرطي.
`args`	`Object[]`	تمثّل هذه السمة مصفوفة من الوسيطات المناسبة لنوع المعايير ويتطابق عدد الوسيطات ونوعها مع طريقة `when...()` المقابلة أعلاه.

استرجاع الكرة

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