Class ConditionalFormatRuleBuilder

ConditionalFormatRuleBuilder

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

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
build()ConditionalFormatRuleتنشئ قاعدة تنسيق شرطي من الإعدادات المطبقة على أداة الإنشاء.
copy()ConditionalFormatRuleBuilderتعرض إعدادًا مسبقًا لأداة إنشاء القواعد باستخدام إعدادات هذه القاعدة.
getBooleanCondition()BooleanConditionاسترداد معلومات BooleanCondition للقاعدة في حال استخدام هذه القاعدة بمعايير الشرط المنطقي.
getGradientCondition()GradientConditionاسترداد معلومات GradientCondition الخاصة بالقاعدة، إذا كانت هذه القاعدة معايير حالة التدرج.
getRanges()Range[]لاسترداد النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.
setBackground(color)ConditionalFormatRuleBuilderلضبط لون الخلفية لتنسيق قاعدة التنسيق الشرطي
setBackgroundObject(color)ConditionalFormatRuleBuilderلضبط لون الخلفية لتنسيق قاعدة التنسيق الشرطي
setBold(bold)ConditionalFormatRuleBuilderلضبط النص الغامق لتنسيق قاعدة التنسيق الشرطي.
setFontColor(color)ConditionalFormatRuleBuilderلتعيين لون الخط لتنسيق قاعدة التنسيق الشرطي.
setFontColorObject(color)ConditionalFormatRuleBuilderلتعيين لون الخط لتنسيق قاعدة التنسيق الشرطي.
setGradientMaxpoint(color)ConditionalFormatRuleBuilderيؤدي إلى محو الحد الأقصى للتدرج في قاعدة التنسيق الشرطي، واستخدام الحد الأقصى بدلاً من ذلك في نطاقات القاعدة.
setGradientMaxpointObject(color)ConditionalFormatRuleBuilderيؤدي إلى محو الحد الأقصى للتدرج في قاعدة التنسيق الشرطي، واستخدام الحد الأقصى بدلاً من ذلك في نطاقات القاعدة.
setGradientMaxpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderتضبط حقول الحدّ الأقصى للتدرج في قاعدة التنسيق الشرطي.
setGradientMaxpointWithValue(color, type, value)ConditionalFormatRuleBuilderتضبط حقول الحدّ الأقصى للتدرج في قاعدة التنسيق الشرطي.
setGradientMidpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderتضبط حقول نقطة منتصف التدرج الخاصة بقاعدة التنسيق الشرطي.
setGradientMidpointWithValue(color, type, value)ConditionalFormatRuleBuilderتضبط حقول نقطة منتصف التدرج الخاصة بقاعدة التنسيق الشرطي.
setGradientMinpoint(color)ConditionalFormatRuleBuilderيؤدي إلى محو قيمة الحد الأدنى للتدرج الخاصة بقاعدة التنسيق الشرطي، واستخدام الحد الأدنى بدلاً من ذلك في نطاقات القاعدة.
setGradientMinpointObject(color)ConditionalFormatRuleBuilderيؤدي إلى محو قيمة الحد الأدنى للتدرج الخاصة بقاعدة التنسيق الشرطي، واستخدام الحد الأدنى بدلاً من ذلك في نطاقات القاعدة.
setGradientMinpointObjectWithValue(color, type, value)ConditionalFormatRuleBuilderتضبط حقول نقاط الحد الأدنى للتدرج الخاصة بقاعدة التنسيق الشرطي.
setGradientMinpointWithValue(color, type, value)ConditionalFormatRuleBuilderتضبط حقول نقاط الحد الأدنى للتدرج الخاصة بقاعدة التنسيق الشرطي.
setItalic(italic)ConditionalFormatRuleBuilderلضبط النص المائل لتنسيق قاعدة التنسيق الشرطي.
setRanges(ranges)ConditionalFormatRuleBuilderتضبط هذه السياسة نطاقًا واحدًا أو أكثر يتم تطبيق قاعدة التنسيق الشرطي هذه عليه.
setStrikethrough(strikethrough)ConditionalFormatRuleBuilderلضبط نص يتوسطه خط لتنسيق قاعدة التنسيق الشرطي.
setUnderline(underline)ConditionalFormatRuleBuilderلإعداد النص الذي تسطير لتنسيق قاعدة التنسيق الشرطي
whenCellEmpty()ConditionalFormatRuleBuilderتضبط قاعدة التنسيق الشرطي ليتم تفعيلها عندما تكون الخلية فارغة.
whenCellNotEmpty()ConditionalFormatRuleBuilderتضبط قاعدة التنسيق الشرطي ليتم تشغيلها عندما لا تكون الخلية فارغة.
whenDateAfter(date)ConditionalFormatRuleBuilderتضبط هذه السياسة قاعدة التنسيق الشرطي ليتم تفعيلها عندما يكون التاريخ بعد القيمة المحدّدة.
whenDateAfter(date)ConditionalFormatRuleBuilderتضبط هذه السياسة قاعدة التنسيق الشرطي ليتم تفعيلها عندما يكون التاريخ بعد التاريخ النسبي المحدَّد.
whenDateBefore(date)ConditionalFormatRuleBuilderلضبط قاعدة التنسيق الشرطي ليتم تفعيلها عندما يكون التاريخ قبل التاريخ المحدّد.
whenDateBefore(date)ConditionalFormatRuleBuilderلضبط قاعدة التنسيق الشرطي ليتم تفعيلها عندما يكون التاريخ قبل التاريخ النسبي المحدّد.
whenDateEqualTo(date)ConditionalFormatRuleBuilderتضبط هذه السياسة قاعدة التنسيق الشرطي ليتم تفعيلها عندما يكون التاريخ مساويًا للتاريخ المحدَّد.
whenDateEqualTo(date)ConditionalFormatRuleBuilderتضبط هذه السياسة قاعدة التنسيق الشرطي ليتم تفعيلها عندما يكون التاريخ مساويًا للتاريخ النسبي المحدَّد.
whenFormulaSatisfied(formula)ConditionalFormatRuleBuilderلضبط قاعدة التنسيق الشرطي ليتم تشغيلها عندما يتم تقييم الصيغة المحددة إلى true.
whenNumberBetween(start, end)ConditionalFormatRuleBuilderلضبط قاعدة التنسيق الشرطي ليتم تشغيلها عندما يقع رقم بين اثنين أو أي منهما القيم المحددة.
whenNumberEqualTo(number)ConditionalFormatRuleBuilderتحدد قاعدة التنسيق الشرطي ليتم تشغيلها عندما يكون الرقم مساويًا للقيمة المحددة.
whenNumberGreaterThan(number)ConditionalFormatRuleBuilderتضبط قاعدة التنسيق الشرطي ليتم تفعيلها عندما يكون أحد الأرقام أكبر من القيمة المقدَّمة.
whenNumberGreaterThanOrEqualTo(number)ConditionalFormatRuleBuilderتتيح هذه السياسة ضبط قاعدة التنسيق الشرطي ليتم تشغيلها عندما يكون الرقم أكبر من القيمة المحدّدة أو يساويها.
whenNumberLessThan(number)ConditionalFormatRuleBuilderتحدد قاعدة التنسيق الشرطي ليتم تشغيلها عندما يكون رقم أقل من محدد
whenNumberLessThanOrEqualTo(number)ConditionalFormatRuleBuilderتحدد قاعدة التنسيق الشرطي ليتم تشغيلها عندما يكون الرقم أقل من أو يساوي القيمة المحددة
whenNumberNotBetween(start, end)ConditionalFormatRuleBuilderتعيين قاعدة التنسيق الشرطي ليتم تشغيلها عندما لا يقع رقم بينه وبين غيرك من، قيمتين محددتين.
whenNumberNotEqualTo(number)ConditionalFormatRuleBuilderتضبط قاعدة التنسيق الشرطي ليتم تشغيلها عندما لا يكون الرقم مساويًا للقيمة المحددة.
whenTextContains(text)ConditionalFormatRuleBuilderتضبط هذه السياسة قاعدة التنسيق الشرطي ليتم تفعيلها عندما يحتوي الإدخال على القيمة المحدّدة.
whenTextDoesNotContain(text)ConditionalFormatRuleBuilderتضبط هذه السياسة قاعدة التنسيق الشرطي ليتم تشغيلها عندما لا يحتوي الإدخال على القيمة المحدّدة.
whenTextEndsWith(text)ConditionalFormatRuleBuilderتضبط هذه السياسة قاعدة التنسيق الشرطي ليتم تفعيلها عند انتهاء الإدخال بالقيمة المحدّدة.
whenTextEqualTo(text)ConditionalFormatRuleBuilderتضبط قاعدة التنسيق الشرطي ليتم تشغيلها عندما يكون الإدخال مساويًا للقيمة المقدَّمة.
whenTextStartsWith(text)ConditionalFormatRuleBuilderتحدِّد هذه السياسة قاعدة التنسيق الشرطي ليتمّ تفعيلها عند بدء الإدخال بالقيمة المحدّدة.
withCriteria(criteria, args)ConditionalFormatRuleBuilderتضبط قاعدة التنسيق الشرطي على المعايير التي تحدّدها قيم BooleanCriteria، مأخوذة عادةً من criteria وarguments قاعدة حالية.

الوثائق التفصيلية

build()

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

الإرجاع

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


copy()

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

الإرجاع

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


getBooleanCondition()

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

// Log the boolean criteria type of the first conditional format rules of a sheet.
var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0];
var booleanCondition = rule.getBooleanCondition();
if (booleanCondition != null) {
  Logger.log(booleanCondition.getCriteriaType());
}

الإرجاع

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


getGradientCondition()

استرداد معلومات GradientCondition الخاصة بالقاعدة، إذا كانت هذه القاعدة معايير حالة التدرج. في الحالات الأخرى، يمكن إرجاع مبلغ null.

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

الإرجاع

GradientCondition — كائن شرط التدرج أو null إذا كانت القاعدة لا تستخدم تدرجًا الشرط.


getRanges()

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

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

الإرجاع

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


setBackground(color)

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

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

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

المعلمات

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

الإرجاع

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


setBackgroundObject(color)

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

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

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

المعلمات

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

الإرجاع

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


setBold(bold)

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

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

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

المعلمات

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

الإرجاع

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


setFontColor(color)

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

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

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

المعلمات

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

الإرجاع

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


setFontColorObject(color)

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

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

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

المعلمات

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

الإرجاع

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


setGradientMaxpoint(color)

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

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

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

المعلمات

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

الإرجاع

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


setGradientMaxpointObject(color)

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

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

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

المعلمات

الاسمالنوعالوصف
colorColorكائن لون الحدّ الأقصى المطلوب ضبطه.

الإرجاع

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


setGradientMaxpointObjectWithValue(color, type, value)

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

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

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

المعلمات

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

الإرجاع

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


setGradientMaxpointWithValue(color, type, value)

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

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

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

المعلمات

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

الإرجاع

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


setGradientMidpointObjectWithValue(color, type, value)

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

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

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

المعلمات

الاسمالنوعالوصف
colorColorلون نقطة المنتصف المطلوب تعيينه.
typeInterpolationTypeنوع الاستيفاء المطلوب ضبطه أو null للمحو
valueStringقيمة نقطة المنتصف المطلوب ضبطها.

الإرجاع

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


setGradientMidpointWithValue(color, type, value)

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

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

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

المعلمات

الاسمالنوعالوصف
colorStringلون نقطة المنتصف المطلوب تعيينه.
typeInterpolationTypeنوع الاستيفاء المطلوب ضبطه أو null للمحو
valueStringقيمة نقطة المنتصف المطلوب ضبطها.

الإرجاع

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


setGradientMinpoint(color)

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

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

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

المعلمات

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

الإرجاع

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


setGradientMinpointObject(color)

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

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

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

المعلمات

الاسمالنوعالوصف
colorColorكائن لون minpoint مطلوب تعيينه.

الإرجاع

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


setGradientMinpointObjectWithValue(color, type, value)

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

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

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

المعلمات

الاسمالنوعالوصف
colorColorلون النقطة الأدنى المطلوب ضبطها.
typeInterpolationTypeنوع استقراء الحد الأدنى المطلوب تعيينه.
valueStringالحد الأدنى لقيمة النقاط المطلوب ضبطها.

الإرجاع

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


setGradientMinpointWithValue(color, type, value)

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

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

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

المعلمات

الاسمالنوعالوصف
colorStringلون النقطة الأدنى المطلوب ضبطها.
typeInterpolationTypeنوع استقراء الحد الأدنى المطلوب تعيينه.
valueStringالحد الأدنى لقيمة النقاط المطلوب ضبطها.

الإرجاع

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


setItalic(italic)

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

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

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

المعلمات

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

الإرجاع

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


setRanges(ranges)

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

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

المعلمات

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

الإرجاع

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


setStrikethrough(strikethrough)

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

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

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

المعلمات

الاسمالنوعالوصف
strikethroughBooleanلتحديد ما إذا كان يجب شطب النص إذا كان شرط التنسيق هو met; وسيزيل تطبيق "null" هذا الإعداد.

الإرجاع

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


setUnderline(underline)

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

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

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

المعلمات

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

الإرجاع

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


whenCellEmpty()

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

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

الإرجاع

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


whenCellNotEmpty()

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

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

الإرجاع

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


whenDateAfter(date)

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

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

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

المعلمات

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

الإرجاع

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


whenDateAfter(date)

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

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

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

المعلمات

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

الإرجاع

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


whenDateBefore(date)

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

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

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

المعلمات

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

الإرجاع

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


whenDateBefore(date)

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

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

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

المعلمات

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

الإرجاع

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


whenDateEqualTo(date)

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

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

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

المعلمات

الاسمالنوعالوصف
dateDateتمثّل هذه السمة التاريخ الوحيد المقبول.

الإرجاع

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


whenDateEqualTo(date)

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

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

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

المعلمات

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

الإرجاع

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


whenFormulaSatisfied(formula)

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

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

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

المعلمات

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

الإرجاع

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


whenNumberBetween(start, end)

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

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

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

المعلمات

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

الإرجاع

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


whenNumberEqualTo(number)

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

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

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

المعلمات

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

الإرجاع

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


whenNumberGreaterThan(number)

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

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

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

المعلمات

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

الإرجاع

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


whenNumberGreaterThanOrEqualTo(number)

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

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

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

المعلمات

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

الإرجاع

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


whenNumberLessThan(number)

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

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

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

المعلمات

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

الإرجاع

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


whenNumberLessThanOrEqualTo(number)

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

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

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

المعلمات

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

الإرجاع

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


whenNumberNotBetween(start, end)

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

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

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

المعلمات

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

الإرجاع

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


whenNumberNotEqualTo(number)

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

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

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

المعلمات

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

الإرجاع

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


whenTextContains(text)

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

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

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

المعلمات

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

الإرجاع

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


whenTextDoesNotContain(text)

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

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

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

المعلمات

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

الإرجاع

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


whenTextEndsWith(text)

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

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

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

المعلمات

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

الإرجاع

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


whenTextEqualTo(text)

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

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

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

المعلمات

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

الإرجاع

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


whenTextStartsWith(text)

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

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

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

المعلمات

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

الإرجاع

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


withCriteria(criteria, args)

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

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

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

المعلمات

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

الإرجاع

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