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

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
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.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

الإرجاع

BooleanCondition: عنصر الشرط المنطقي، أو null إذا كانت القاعدة لا تستخدم شرطًا منطقيًا

---

getGradientCondition()

يسترجع معلومات GradientCondition للقاعدة، إذا كانت هذه القاعدة تستخدِم معايير حالة متدرّجة. بخلاف ذلك، يتم عرض null.

// Log the gradient minimum color of the first conditional format rule of a
// sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const gradientCondition = rule.getGradientCondition();
if (gradientCondition != null) {
  // Assume the color has ColorType.RGB.
  Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString());
}

الإرجاع

GradientCondition: عنصر شرط التدرّج، أو null إذا كانت القاعدة لا تستخدِم شرط التدرّج

---

getRanges()

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

// Log each range of the first conditional format rule of a sheet.
const rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
const ranges = rule.getRanges();
for (let i = 0; i < ranges.length; i++) {
  Logger.log(ranges[i].getA1Notation());
}

الإرجاع

Range[]: النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها

---

setBackground(color)

لضبط لون الخلفية لتنسيق قاعدة التنسيق الشرطي. يؤدي إدخال null إلى إزالة إعداد تنسيق لون الخلفية من القاعدة.

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

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

المعلمات

الاسم	النوع	الوصف
color	String	اللون المطلوب أو null لمحو المحتوى

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

setBackgroundObject(color)

لضبط لون الخلفية لتنسيق قاعدة التنسيق الشرطي. يؤدي إدخال null إلى إزالة إعداد تنسيق لون الخلفية من القاعدة.

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

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

المعلمات

الاسم	النوع	الوصف
color	Color	عنصر اللون المطلوب أو null لمحو اللون

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء لتسلسل العناصر

---

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".

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

setFontColor(color)

لضبط لون الخط لتنسيق قاعدة التنسيق الشرطي. يؤدي إدخال null إلى إزالة إعداد تنسيق لون الخط من القاعدة.

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

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

المعلمات

الاسم	النوع	الوصف
color	String	اللون المطلوب أو null لمحو المحتوى

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

setFontColorObject(color)

لضبط لون الخط لتنسيق قاعدة التنسيق الشرطي. يؤدي إدخال null إلى إزالة إعداد تنسيق لون الخط من القاعدة.

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

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

المعلمات

الاسم	النوع	الوصف
color	Color	عنصر اللون المطلوب أو null لمحو اللون

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء لتسلسل العناصر

---

setGradientMaxpoint(color)

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

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

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

المعلمات

الاسم	النوع	الوصف
color	String	لون النقطة القصوى المطلوب ضبطه

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

setGradientMaxpointObject(color)

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

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

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

المعلمات

الاسم	النوع	الوصف
color	Color	عنصر لون النقطة القصوى المطلوب ضبطه

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء لتسلسل العناصر

---

setGradientMaxpointObjectWithValue(color, type, value)

تُستخدَم لضبط حقول الحد الأقصى للنقطة في التدرّج لقاعدة التنسيق الشرطي.

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

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

المعلمات

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

الإرجاع

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.

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

المعلمات

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

الإرجاع

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.

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء لتسلسل العناصر

---

setGradientMidpointWithValue(color, type, value)

تُستخدَم لضبط حقول منتصف التدرّج لقاعدة التنسيق الشرطي. تمحو هذه الدالة جميع حقول منتصف الفاصل إذا كان نوع الاستقراء الذي تم تمريره هو null.

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

setGradientMinpoint(color)

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

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

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

المعلمات

الاسم	النوع	الوصف
color	String	لون النقطة الدنيا المطلوب ضبطه

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

setGradientMinpointObject(color)

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

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

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

المعلمات

الاسم	النوع	الوصف
color	Color	عنصر لون النقطة الدنيا المطلوب ضبطه

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء لتسلسل العناصر

---

setGradientMinpointObjectWithValue(color, type, value)

تُستخدَم لضبط حقول الحد الأدنى للنقطة في التدرّج لقاعدة التنسيق الشرطي.

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء لتسلسل العناصر

---

setGradientMinpointWithValue(color, type, value)

تُستخدَم لضبط حقول الحد الأدنى للنقطة في التدرّج لقاعدة التنسيق الشرطي.

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

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".

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

setRanges(ranges)

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

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".

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

setUnderline(underline)

لضبط تسطير النص لتنسيق قاعدة التنسيق الشرطي إذا كان underline هو true، تُحاذي القاعدة النص إذا تم استيفاء الشرط. وإذا كان false، تزيل القاعدة أي خطوط تحتية حالية في حال استيفاء الشرط. يؤدي إدخال null إلى إزالة إعداد التنسيق sublined من القاعدة.

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenCellEmpty()

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

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenCellNotEmpty()

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

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenDateAfter(date)

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

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

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

المعلمات

الاسم	النوع	الوصف
date	Date	آخر تاريخ.

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenDateAfter(date)

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

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

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

المعلمات

الاسم	النوع	الوصف
date	RelativeDate	آخر تاريخ نسبةً إلى نوع التاريخ المحدّد.

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenDateBefore(date)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenDateBefore(date)

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

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

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

المعلمات

الاسم	النوع	الوصف
date	RelativeDate	آخر تاريخ نسبةً إلى نوع التاريخ المحدّد.

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenDateEqualTo(date)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenDateEqualTo(date)

لضبط قاعدة التنسيق الشرطي لتفعيلها عندما يكون التاريخ مساويًا للتاريخ النسبي المحدَّد

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

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

المعلمات

الاسم	النوع	الوصف
date	RelativeDate	آخر تاريخ نسبةً إلى نوع التاريخ المحدّد.

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenFormulaSatisfied(formula)

لضبط قاعدة التنسيق الشرطي لتفعيلها عندما يتم تقييم الصيغة المحدّدة على أنّها true.

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenNumberBetween(start, end)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenNumberEqualTo(number)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenNumberGreaterThan(number)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenNumberGreaterThanOrEqualTo(number)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenNumberLessThan(number)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenNumberLessThanOrEqualTo(number)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenNumberNotBetween(start, end)

لضبط قاعدة التنسيق الشرطي لتفعيلها عندما لا يقع رقم بين قيمتَين محدّدتَين ولا يمثّل أيًا منهما

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenNumberNotEqualTo(number)

لضبط قاعدة التنسيق الشرطي لتفعيلها عندما لا يكون الرقم مساويًا للقيمة المحدّدة

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenTextContains(text)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenTextDoesNotContain(text)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenTextEndsWith(text)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenTextEqualTo(text)

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

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

whenTextStartsWith(text)

لضبط قاعدة التنسيق الشرطي لتفعيلها عندما يبدأ الإدخال بالقيمة المحدّدة.

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر

---

withCriteria(criteria, args)

تضبط قاعدة التنسيق الشرطي على معايير محدّدة بواسطة قيم BooleanCriteria، التي يتم عادةً أخذها من criteria وarguments لقاعدة حالية.

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

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

المعلمات

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

الإرجاع

ConditionalFormatRuleBuilder — أداة الإنشاء، لتسلسل العناصر