أداة إنشاء قواعد التنسيق الشرطي.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
build() | ConditionalFormatRule | إنشاء قاعدة تنسيق شرطي من الإعدادات المُطبّقة على أداة الإنشاء. |
copy() | ConditionalFormatRuleBuilder | لعرض إعدادات مسبقة لإنشاء القواعد باستخدام إعدادات هذه القاعدة. |
getBooleanCondition() | BooleanCondition | لاسترداد معلومات BooleanCondition القاعدة إذا كانت هذه القاعدة تستخدم معايير شرطية منطقية. |
getGradientCondition() | GradientCondition | لاسترداد معلومات GradientCondition \u30s، في حال كانت هذه القاعدة تستخدم معايير شرط التدرج. |
getRanges() | Range[] | لاسترداد النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها. |
setBackground(color) | ConditionalFormatRuleBuilder | لضبط لون الخلفية لتنسيق التنسيق الشرطي. |
setBackgroundObject(color) | ConditionalFormatRuleBuilder | لضبط لون الخلفية لتنسيق التنسيق الشرطي. |
setBold(bold) | ConditionalFormatRuleBuilder | لضبط النص بالخط الغامق لتنسيق قاعدة الشرط الشرطية. |
setFontColor(color) | ConditionalFormatRuleBuilder | لضبط لون الخط لتنسيق التنسيق الشرطي's. |
setFontColorObject(color) | ConditionalFormatRuleBuilder | لضبط لون الخط لتنسيق التنسيق الشرطي's. |
setGradientMaxpoint(color) | ConditionalFormatRuleBuilder | يؤدي هذا الإعداد إلى محو قيمة الحد الأقصى للمقياس المتدرّج للقواعد، ويستخدم بدلاً من ذلك الحد الأقصى للقيمة في نطاقات القاعدة. |
setGradientMaxpointObject(color) | ConditionalFormatRuleBuilder | يؤدي هذا الإعداد إلى محو قيمة الحد الأقصى للمقياس المتدرّج للقواعد، ويستخدم بدلاً من ذلك الحد الأقصى للقيمة في نطاقات القاعدة. |
setGradientMaxpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | تضبط هذه السياسة حقول الحد الأقصى للتدرج المتدرج. |
setGradientMaxpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | تضبط هذه السياسة حقول الحد الأقصى للتدرج المتدرج. |
setGradientMidpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | لضبط حقول نقطةالشرط المتدرّجة في قاعدة الشرط المشروطة. |
setGradientMidpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | لضبط حقول نقطةالشرط المتدرّجة في قاعدة الشرط المشروطة. |
setGradientMinpoint(color) | ConditionalFormatRuleBuilder | يؤدي ذلك إلى محو قيمة النقطة الحدية للقواعد الشرطية، ويستخدم بدلاً من ذلك الحد الأدنى من القيمة في نطاقات القاعدة. |
setGradientMinpointObject(color) | ConditionalFormatRuleBuilder | يؤدي ذلك إلى محو قيمة النقطة الحدية للقواعد الشرطية، ويستخدم بدلاً من ذلك الحد الأدنى من القيمة في نطاقات القاعدة. |
setGradientMinpointObjectWithValue(color, type, value) | ConditionalFormatRuleBuilder | لضبط حقول النقطة الحدية للتدرّج قاعدة الشرط الشرطية. |
setGradientMinpointWithValue(color, type, value) | ConditionalFormatRuleBuilder | لضبط حقول النقطة الحدية للتدرّج قاعدة الشرط الشرطية. |
setItalic(italic) | ConditionalFormatRuleBuilder | لضبط الخط المائل لنص التنسيق الشرطي's. |
setRanges(ranges) | ConditionalFormatRuleBuilder | تحدد نطاقًا واحدًا أو أكثر يتم تطبيق قاعدة التنسيق الشرطي عليه. |
setStrikethrough(strikethrough) | ConditionalFormatRuleBuilder | لضبط خط يتوسطه النص لتنسيق القاعدة الشرطية. |
setUnderline(underline) | ConditionalFormatRuleBuilder | لتحديد النص الذي تحته تنسيق التنسيق الشرطي للقواعد. |
whenCellEmpty() | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما تكون الخلية فارغة. |
whenCellNotEmpty() | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي ليتم تشغيلها عندما لا تكون الخلية فارغة. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ بعد القيمة المحددة. |
whenDateAfter(date) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ بعد التاريخ النسبي المحدد. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ قبل التاريخ المحدد. |
whenDateBefore(date) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ قبل التاريخ النسبي المحدد. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ مساويًا لتاريخ معين. |
whenDateEqualTo(date) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ مساويًا للتاريخ النسبي. |
whenFormulaSatisfied(formula) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند تقييم الصيغة المحددة على true . |
whenNumberBetween(start, end) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند حدوث رقم بين قيمتين محددتين أو تكون أيًا منهما. |
whenNumberEqualTo(number) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون أحد الأرقام مساويًا للقيمة المحددة. |
whenNumberGreaterThan(number) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون أحد الأرقام أكبر من القيمة المحددة. |
whenNumberGreaterThanOrEqualTo(number) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون أحد الأرقام أكبر من أو يساوي القيمة المحددة. |
whenNumberLessThan(number) | ConditionalFormatRuleBuilder | تتيح هذه السياسة ضبط قاعدة التنسيق الشرطي المشروط ليتم تشغيلها عندما يكون الرقم أقل من القيمة المحددة. |
whenNumberLessThanOrEqualTo(number) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون الرقم أقل من أو يساوي القيمة المحددة. |
whenNumberNotBetween(start, end) | ConditionalFormatRuleBuilder | تعمل هذه السياسة على ضبط قاعدة التنسيق الشرطي لكي يتم تشغيلها عند عدم وجود رقم بين قيمتين محدّدتين، وليس أيًا منهما. |
whenNumberNotEqualTo(number) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما لا يكون أحد الأرقام مساويًا للقيمة المحددة. |
whenTextContains(text) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يحتوي الإدخال على القيمة المحددة. |
whenTextDoesNotContain(text) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما لا يحتوي الإدخال على القيمة المحددة. |
whenTextEndsWith(text) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند انتهاء الإدخال بالقيمة المحددة. |
whenTextEqualTo(text) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون الإدخال مساويًا للقيمة المحددة. |
whenTextStartsWith(text) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند بدء الإدخال بالقيمة المحددة. |
withCriteria(criteria, args) | ConditionalFormatRuleBuilder | لضبط قاعدة التنسيق الشرطي على المعايير التي تحددها قيم BooleanCriteria ، ويتم عادةً الحصول عليها من criteria وarguments لقاعدة حالية. |
المستندات التفصيلية
build()
إنشاء قاعدة تنسيق شرطي من الإعدادات المُطبّقة على أداة الإنشاء.
تذكرة ذهاب وعودة
ConditionalFormatRule
: تمثيل لقاعدة التنسيق الشرطي
copy()
لعرض إعدادات مسبقة لإنشاء القواعد باستخدام إعدادات هذه القاعدة.
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
- أداة إنشاء استنادًا إلى إعدادات هذه القاعدة
getBooleanCondition()
لاسترداد معلومات BooleanCondition
القاعدة إذا كانت هذه القاعدة تستخدم معايير شرطية منطقية. بخلاف ذلك، يتم إرجاع null
.
// Log the boolean criteria type of the first conditional format rules of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var booleanCondition = rule.getBooleanCondition(); if (booleanCondition != null) { Logger.log(booleanCondition.getCriteriaType()); }
تذكرة ذهاب وعودة
BooleanCondition
— كائن الشرط المنطقي، أو null
إذا لم تستخدم القاعدة شرطًا منطقيًا.
getGradientCondition()
لاسترداد معلومات GradientCondition
\u30s، في حال كانت هذه القاعدة تستخدم معايير شرط التدرج. بخلاف ذلك، يتم إرجاع null
.
// Log the gradient minimum color of the first conditional format rule of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var gradientCondition = rule.getGradientCondition(); if (gradientCondition != null) { // Assume the color has ColorType.RGB. Logger.log(gradientCondition.getMinColorObject().asRgbColor().asHexString()); }
تذكرة ذهاب وعودة
GradientCondition
- كائن شرط التدرج، أو null
إذا لم تستخدم القاعدة شرطًا.
getRanges()
لاسترداد النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.
// Log each range of the first conditional format rule of a sheet. var rule = SpreadsheetApp.getActiveSheet().getConditionalFormatRules()[0]; var ranges = rule.getRanges(); for (var i = 0; i < ranges.length; i++) { Logger.log(ranges[i].getA1Notation()); }
تذكرة ذهاب وعودة
Range[]
- النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها.
setBackground(color)
لضبط لون الخلفية لتنسيق التنسيق الشرطي. يؤدي تمرير null
إلى إزالة إعداد تنسيق لون الخلفية من القاعدة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color to red if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | String | اللون المطلوب أو null المطلوب محوه. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setBackgroundObject(color)
لضبط لون الخلفية لتنسيق التنسيق الشرطي. يؤدي تمرير null
إلى إزالة إعداد تنسيق لون الخلفية من القاعدة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color to theme background color if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBackground(color) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | Color | كائن اللون المطلوب أو null المطلوب محوه. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل.
setBold(bold)
لضبط النص بالخط الغامق لتنسيق قاعدة الشرط الشرطية. وإذا كان bold
هو true
،
ستظهر القاعدة بخط غامق في حال استيفاء الشرط. وإذا كان false
، ستزيل القاعدة أي نص غامق حالي في حال استيفاء الشرط. يؤدي تمرير null
إلى إزالة إعداد التنسيق الغامق من
القاعدة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their // text bold if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBold(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
bold | Boolean | لتحديد ما إذا كان يجب عرض النص بالخط الغامق أم لا في حال استيفاء شرط التنسيق. يزيل null هذا الإعداد. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setFontColor(color)
لضبط لون الخط لتنسيق التنسيق الشرطي's. يؤدي تمرير null
إلى إزالة إعداد تنسيق لون الخط من القاعدة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font // color to red if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setFontColor("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | String | اللون المطلوب أو null المطلوب محوه. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setFontColorObject(color)
لضبط لون الخط لتنسيق التنسيق الشرطي's. يؤدي تمرير null
إلى إزالة إعداد تنسيق لون الخط من القاعدة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their font // color to theme text color if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setFontColor(color) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | Color | كائن اللون المطلوب أو null المطلوب محوه. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل.
setGradientMaxpoint(color)
يؤدي هذا الإعداد إلى محو قيمة الحد الأقصى للمقياس المتدرّج للقواعد، ويستخدم بدلاً من ذلك الحد الأقصى للقيمة في نطاقات القاعدة. يعمل أيضًا على ضبط لون الحد الأقصى للتدرّج'، على لون الإدخال.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between white and red, based on their values in comparison to // the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint("#FF0000") .setGradientMinpoint("#FFFFFF") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | String | لون الحد الأقصى الذي يجب ضبطه. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setGradientMaxpointObject(color)
يؤدي هذا الإعداد إلى محو قيمة الحد الأقصى للمقياس المتدرّج للقواعد، ويستخدم بدلاً من ذلك الحد الأقصى للقيمة في نطاقات القاعدة. يعمل أيضًا على ضبط لون الحد الأقصى للتدرّج'، على لون الإدخال.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between theme text and background colors, based on their values // in comparison to the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var textColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var backgroundColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint(textColor) .setGradientMinpoint(backgroundColor) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | Color | عنصر لون الحد الأقصى المراد إعداده. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل.
setGradientMaxpointObjectWithValue(color, type, value)
تضبط هذه السياسة حقول الحد الأقصى للتدرج المتدرج.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from theme accent 1, accent 2 to accent 3 colors, based on their // values in comparison to the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | Color | لون الحد الأقصى الذي يجب ضبطه. |
type | InterpolationType | تمثّل هذه الخاصية نوع إقحام الحد الأقصى المطلوب ضبطه. |
value | String | تمثّل هذه السمة القيمة القصوى التي يجب ضبطها. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل.
setGradientMaxpointWithValue(color, type, value)
تضبط هذه السياسة حقول الحد الأقصى للتدرج المتدرج.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from red green to blue, based on their values in comparison to // the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | String | لون الحد الأقصى الذي يجب ضبطه. |
type | InterpolationType | تمثّل هذه الخاصية نوع إقحام الحد الأقصى المطلوب ضبطه. |
value | String | تمثّل هذه السمة القيمة القصوى التي يجب ضبطها. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setGradientMidpointObjectWithValue(color, type, value)
لضبط حقول نقطةالشرط المتدرّجة في قاعدة الشرط المشروطة. يمحو كل حقول نقطة النهاية إذا كان نوع التمرير في الحقل الخاص بالاستخلاص هو null
.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from theme accent 1 to accent 2 to accent 3 colors, based on // their values in comparison to the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var color1 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT1) .build(); var color2 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT2) .build(); var color3 = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.ACCENT3) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue(color1, SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue(color2, SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue(color3, SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | Color | لون نقطة المنتصف المراد ضبطها. |
type | InterpolationType | نوع إقحام نقطة النهاية المراد ضبطها أو null لمحوه. |
value | String | تمثّل هذه السمة قيمة نقطة المنتصف. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل.
setGradientMidpointWithValue(color, type, value)
لضبط حقول نقطةالشرط المتدرّجة في قاعدة الشرط المشروطة. يمحو كل حقول نقطة النهاية إذا كان نوع التمرير في الحقل الخاص بالاستخلاص هو null
.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from red green to blue, based on their values in comparison to // the values 0, 50, and 100. 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);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | String | لون نقطة المنتصف المراد ضبطها. |
type | InterpolationType | نوع إقحام نقطة النهاية المراد ضبطها أو null لمحوه. |
value | String | تمثّل هذه السمة قيمة نقطة المنتصف. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setGradientMinpoint(color)
يؤدي ذلك إلى محو قيمة النقطة الحدية للقواعد الشرطية، ويستخدم بدلاً من ذلك الحد الأدنى من القيمة في نطاقات القاعدة. يؤدي هذا الخيار أيضًا إلى ضبط لون نقطة الحد الأدنى "التدرّج" على لون الإدخال.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between white and red, based on their values in comparison to // the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint("#FF0000") .setGradientMinpoint("#FFFFFF") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | String | لون النقطة الأدنى المطلوب ضبطها |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setGradientMinpointObject(color)
يؤدي ذلك إلى محو قيمة النقطة الحدية للقواعد الشرطية، ويستخدم بدلاً من ذلك الحد الأدنى من القيمة في نطاقات القاعدة. يؤدي هذا الخيار أيضًا إلى ضبط لون نقطة الحد الأدنى "التدرّج" على لون الإدخال.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere between theme text and background colors, based on their values // in comparison to the ranges minimum and maximum values. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var textColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.TEXT) .build(); var backgroundColor = SpreadsheetApp.newColor() .setThemeColor(SpreadsheetApp.ThemeColorType.BACKGROUND) .build(); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpoint(textColor) .setGradientMinpoint(backgroundColor) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
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. 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);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | Color | لون النقطة الأدنى المطلوب ضبطها |
type | InterpolationType | نوع إضافة الحد الأدنى المطلوب لضبطه. |
value | String | تمثّل هذه الخاصية قيمة الحد الأدنى المطلوب ضبطها. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل.
setGradientMinpointWithValue(color, type, value)
لضبط حقول النقطة الحدية للتدرّج قاعدة الشرط الشرطية.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to set their // background color somewhere from red to green to blue, based on their values in comparison to // the values 0, 50, and 100. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .setGradientMaxpointWithValue("#0000FF", SpreadsheetApp.InterpolationType.NUMBER, "100") .setGradientMidpointWithValue("#00FF00", SpreadsheetApp.InterpolationType.NUMBER, "50") .setGradientMinpointWithValue("#FF0000", SpreadsheetApp.InterpolationType.NUMBER, "0") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
color | String | لون النقطة الأدنى المطلوب ضبطها |
type | InterpolationType | نوع إضافة الحد الأدنى المطلوب لضبطه. |
value | String | تمثّل هذه الخاصية قيمة الحد الأدنى المطلوب ضبطها. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setItalic(italic)
لضبط الخط المائل لنص التنسيق الشرطي's. إذا كان italic
هو true
،
تجعل القاعدة النص مائلاً في حال استيفاء الشرط. وإذا كانت false
، تزيل القاعدة أي خط مائل حالي في حال استيفاء الشرط. يؤدي تمرير null
إلى إزالة إعداد التنسيق المائل من القاعدة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn their // text italic if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setItalic(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
italic | Boolean | لتحديد ما إذا كان يجب أن يكون النص مائلاً في حال استيفاء شرط التنسيق أم لا.
يزيل null هذا الإعداد. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setRanges(ranges)
تحدد نطاقًا واحدًا أو أكثر يتم تطبيق قاعدة التنسيق الشرطي عليه. تحل هذه العملية تحل محل أي نطاقات حالية. ويؤدي ضبط مصفوفة فارغة إلى محو أي نطاقات حالية. يجب أن تحتوي القاعدة على نطاق واحد على الأقل.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 and range D4:F6 // to turn red if they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var rangeOne = sheet.getRange("A1:B3"); var rangeTwo = sheet.getRange("D4:F6"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([rangeOne, rangeTwo]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
ranges | Range[] | النطاقات التي يتم تطبيق قاعدة التنسيق الشرطي هذه عليها. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setStrikethrough(strikethrough)
لضبط خط يتوسطه النص لتنسيق القاعدة الشرطية. إذا كان strikethrough
هو true
، فإن نص القاعدة يتوسطه خط إذا تم استيفاء الشرط. وإذا كان false
، ستؤدي القاعدة إلى إزالة أي تنسيق يتوسطه خط حالي في حال استيفاء الشرط. يؤدي تمرير null
إلى إزالة إعداد تنسيق يتوسطه خط من القاعدة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to strikethrough // their text if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setStrikethrough(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
strikethrough | Boolean | تبيّن أنّ النص يجب أن يتوسطه خط في حال استيفاء شرط التنسيق، لأنّ null يزيل هذا الإعداد. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
setUnderline(underline)
لتحديد النص الذي تحته تنسيق التنسيق الشرطي للقواعد. إذا كان underline
هو true
، تُسطِّر القاعدة النص في حال استيفاء الشرط. وإذا كان false
، تُزيل القاعدة أي تسطير حالي في حال استيفاء الشرط. يؤدي تمرير null
إلى إزالة إعداد تنسيق التسطير من القاعدة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to underline // their text if the cell has text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setUnderline(true) .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
underline | Boolean | لتحديد ما إذا كان يجب تسطير النص في حال استيفاء شرط التنسيق أم لا،
يزيل null هذا الإعداد. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenCellEmpty()
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما تكون الخلية فارغة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they are empty. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenCellEmpty() .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenCellNotEmpty()
لضبط قاعدة التنسيق الشرطي ليتم تشغيلها عندما لا تكون الخلية فارغة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they are not empty. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenCellNotEmpty() .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenDateAfter(date)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ بعد القيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date after 11/4/1993. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateAfter(new Date("11/4/1993")) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
date | Date | التاريخ الأخير |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenDateAfter(date)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ بعد التاريخ النسبي المحدد.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date after today. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateAfter(SpreadsheetApp.RelativeDate.TODAY) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
date | RelativeDate | أحدث تاريخ بالنسبة إلى نوع التاريخ المحدّد |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenDateBefore(date)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ قبل التاريخ المحدد.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date before 11/4/1993. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateBefore(new Date("11/4/1993")) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
date | Date | أقرب تاريخ غير مقبول |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenDateBefore(date)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ قبل التاريخ النسبي المحدد.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a date before today. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateBefore(SpreadsheetApp.RelativeDate.TODAY) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
date | RelativeDate | أحدث تاريخ بالنسبة إلى نوع التاريخ المحدّد |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenDateEqualTo(date)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ مساويًا لتاريخ معين.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain the date 11/4/1993. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateEqualTo(new Date("11/4/1993")) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
date | Date | التاريخ الوحيد المقبول |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenDateEqualTo(date)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون التاريخ مساويًا للتاريخ النسبي.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain todays date. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenDateEqualTo(SpreadsheetApp.RelativeDate.TODAY) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
date | RelativeDate | أحدث تاريخ بالنسبة إلى نوع التاريخ المحدّد |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenFormulaSatisfied(formula)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند تقييم الصيغة المحددة على true
.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they satisfy the condition "=EQ(B4, C3)". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenFormulaSatisfied("=EQ(B4, C3)") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
formula | String | صيغة مخصّصة يتم تقييمها على true إذا كان الإدخال صالحًا. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenNumberBetween(start, end)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند حدوث رقم بين قيمتين محددتين أو تكون أيًا منهما.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
start | Number | تمثّل هذه السمة أدنى قيمة مقبولة. |
end | Number | أعلى قيمة مقبولة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenNumberEqualTo(number)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون أحد الأرقام مساويًا للقيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain the number 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | القيمة الوحيدة المقبولة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenNumberGreaterThan(number)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون أحد الأرقام أكبر من القيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red // if they contain a number greater than 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberGreaterThan(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | أعلى قيمة غير مقبولة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenNumberGreaterThanOrEqualTo(number)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون أحد الأرقام أكبر من أو يساوي القيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number greater than or equal to 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberGreaterThanOrEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | تمثّل هذه السمة أدنى قيمة مقبولة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenNumberLessThan(number)
تتيح هذه السياسة ضبط قاعدة التنسيق الشرطي المشروط ليتم تشغيلها عندما يكون الرقم أقل من القيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number less than 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberLessThan(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | أدنى قيمة غير مقبولة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenNumberLessThanOrEqualTo(number)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون الرقم أقل من أو يساوي القيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number less than or equal to 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberLessThanOrEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | أعلى قيمة مقبولة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenNumberNotBetween(start, end)
تعمل هذه السياسة على ضبط قاعدة التنسيق الشرطي لكي يتم تشغيلها عند عدم وجود رقم بين قيمتين محدّدتين، وليس أيًا منهما.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain a number not between 1 and 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberNotBetween(1, 10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
start | Number | أدنى قيمة غير مقبولة. |
end | Number | أعلى قيمة غير مقبولة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenNumberNotEqualTo(number)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما لا يكون أحد الأرقام مساويًا للقيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they don't contain the number 10. var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenNumberNotEqualTo(10) .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
number | Number | القيمة الوحيدة غير المقبولة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenTextContains(text)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يحتوي الإدخال على القيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they contain the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextContains("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | القيمة التي يجب أن يحتوي عليها الإدخال. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenTextDoesNotContain(text)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما لا يحتوي الإدخال على القيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they don't contain the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextDoesNotContain("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | القيمة التي يجب ألا يحتوي عليها الإدخال |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenTextEndsWith(text)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند انتهاء الإدخال بالقيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they end with the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEndsWith("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | النص المطلوب مقارنته بنهاية السلسلة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenTextEqualTo(text)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عندما يكون الإدخال مساويًا للقيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they have text equal to "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextEqualTo("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | القيمة الوحيدة المقبولة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
whenTextStartsWith(text)
لضبط قاعدة التنسيق الشرطي بحيث يتم تشغيلها عند بدء الإدخال بالقيمة المحددة.
// Adds a conditional format rule to a sheet that causes cells in range A1:B3 to turn red if // they start with the text "hello". var sheet = SpreadsheetApp.getActiveSheet(); var range = sheet.getRange("A1:B3"); var rule = SpreadsheetApp.newConditionalFormatRule() .whenTextStartsWith("hello") .setBackground("#FF0000") .setRanges([range]) .build(); var rules = sheet.getConditionalFormatRules(); rules.push(rule); sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | النص المطلوب مقارنته ببداية السلسلة. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل
withCriteria(criteria, args)
لضبط قاعدة التنسيق الشرطي على المعايير التي تحددها قيم BooleanCriteria
، ويتم عادةً الحصول عليها من criteria
وarguments
لقاعدة حالية.
// Adds a new conditional format rule that is a copy of the first active // conditional format rule, except it instead sets its cells to have a black // background color. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); var booleanCondition = rules[0].getBooleanCondition(); if (booleanCondition != null) { var rule = SpreadsheetApp.newConditionalFormatRule() .withCriteria(booleanCondition.getCriteriaType(), booleanCondition.getCriteriaValues()) .setBackground("#000000") .setRanges(rule.getRanges()) .build(); rules.push(rule); } sheet.setConditionalFormatRules(rules);
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
criteria | BooleanCriteria | نوع معايير التنسيق الشرطي. |
args | Object[] | مصفوفة من الوسيطات المناسبة لنوع المعايير، وعدد الوسيطات ونوعها يتطابق مع طريقة when...() المقابلة أعلاه. |
تذكرة ذهاب وعودة
ConditionalFormatRuleBuilder
— أداة الإنشاء للسلاسل