تمت ترجمة هذه الصفحة بواسطة 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.
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)`

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

// 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`	نوع الاستيفاء maxpoint المطلوب ضبطه.
`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.

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`	نوع الاستيفاء maxpoint المطلوب ضبطه.
`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.

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

// 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`	نوع الاستيفاء minpoint المطلوب ضبطه.
`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`	نوع الاستيفاء minpoint المطلوب ضبطه.
`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 إلى إزالة إعداد التنسيق الذي يتضمّن خطًا سفليًا من القاعدة.

// 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: أداة الإنشاء، لتسلسل العمليات

Class ConditionalFormatRuleBuilder تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الطُرق

مستندات مفصّلة

build()

الإرجاع

copy()

الإرجاع

getBooleanCondition()

الإرجاع

getGradientCondition()

الإرجاع

getRanges()

الإرجاع

setBackground(color)

المعلمات

الإرجاع

setBackgroundObject(color)

المعلمات

الإرجاع

setBold(bold)

المعلمات

الإرجاع

setFontColor(color)

المعلمات

الإرجاع

setFontColorObject(color)

المعلمات

الإرجاع

setGradientMaxpoint(color)

المعلمات

الإرجاع

setGradientMaxpointObject(color)

المعلمات

الإرجاع

setGradientMaxpointObjectWithValue(color, type, value)

المعلمات

الإرجاع

setGradientMaxpointWithValue(color, type, value)

المعلمات

الإرجاع

setGradientMidpointObjectWithValue(color, type, value)

المعلمات

الإرجاع

setGradientMidpointWithValue(color, type, value)

المعلمات

الإرجاع

setGradientMinpoint(color)

المعلمات

الإرجاع

setGradientMinpointObject(color)

المعلمات

الإرجاع

setGradientMinpointObjectWithValue(color, type, value)

المعلمات

الإرجاع

setGradientMinpointWithValue(color, type, value)

المعلمات

الإرجاع

setItalic(italic)

المعلمات

الإرجاع

setRanges(ranges)

المعلمات

الإرجاع

setStrikethrough(strikethrough)

المعلمات

الإرجاع

setUnderline(underline)

المعلمات

الإرجاع

whenCellEmpty()

الإرجاع

whenCellNotEmpty()

الإرجاع

whenDateAfter(date)

المعلمات

الإرجاع

whenDateAfter(date)

المعلمات

الإرجاع

Class ConditionalFormatRuleBuilder

`build()`

`copy()`

`getBooleanCondition()`

`getGradientCondition()`

`getRanges()`

`setBackground(color)`

`setBackgroundObject(color)`

`setBold(bold)`

`setFontColor(color)`

`setFontColorObject(color)`

`setGradientMaxpoint(color)`

`setGradientMaxpointObject(color)`

`setGradientMaxpointObjectWithValue(color, type, value)`

`setGradientMaxpointWithValue(color, type, value)`

`setGradientMidpointObjectWithValue(color, type, value)`

`setGradientMidpointWithValue(color, type, value)`

`setGradientMinpoint(color)`

`setGradientMinpointObject(color)`

`setGradientMinpointObjectWithValue(color, type, value)`

`setGradientMinpointWithValue(color, type, value)`

`setItalic(italic)`

`setRanges(ranges)`

`setStrikethrough(strikethrough)`

`setUnderline(underline)`

`whenCellEmpty()`

`whenCellNotEmpty()`

`whenDateAfter(date)`

`whenDateAfter(date)`

`whenDateBefore(date)`

`whenDateBefore(date)`

`whenDateEqualTo(date)`

`whenDateEqualTo(date)`

`whenFormulaSatisfied(formula)`

`whenNumberBetween(start, end)`

`whenNumberEqualTo(number)`

`whenNumberGreaterThan(number)`

`whenNumberGreaterThanOrEqualTo(number)`

`whenNumberLessThan(number)`

`whenNumberLessThanOrEqualTo(number)`

`whenNumberNotBetween(start, end)`

`whenNumberNotEqualTo(number)`

`whenTextContains(text)`

`whenTextDoesNotContain(text)`

`whenTextEndsWith(text)`

`whenTextEqualTo(text)`

`whenTextStartsWith(text)`

`withCriteria(criteria, args)`