الوصول إلى شروط التدرج (اللون) في ConditionalFormatRuleApis
.
ويمكن أن تحتوي كل قاعدة تنسيق شرطي على شرط تدرج واحد. يتم تحديد شرط التدرج باستخدام ثلاث نقاط على مقياس عدد (الحد الأدنى والمتوسّط والحد الأقصى)، ولكل منها لون وقيمة وInterpolationType
. وتتم مقارنة محتوى الخلية
مع القيم في مقياس الأرقام، ويتم تلوين اللون الذي تم تطبيقه على الخلية
بالاستناد إلى مدى اقتراب محتوى الخلية من الحد الأدنى لشرط التدرج والمتوسط والحد الأقصى للنقاط.
// Logs all the information inside gradient conditional format rules on a sheet. // The below snippet assumes all colors have ColorType.RGB. var sheet = SpreadsheetApp.getActiveSheet(); var rules = sheet.getConditionalFormatRules(); for (int i = 0; i < rules.length; i++) { var gradient = rules[i].getGradientCondition(); Logger.log("The conditional format gradient information for rule %d:\n MinColor %s, MinType %s, MinValue %s, \n MidColor %s, MidType %s, MidValue %s, \n MaxColor %s, MaxType %s, MaxValue %s \n", i, gradient.getMinColorObject().asRgbColor().asHexString(), gradient.getMinType(), gradient.getMinValue(), gradient.getMidColorObject().asRgbColor().asHexString(), gradient.getMidType(), gradient.getMidValue(), gradient.getMaxColorObject().asRgbColor().asHexString(), gradient.getMaxType(), gradient.getMaxValue()); }
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
getMaxColorObject() | Color | للحصول على مجموعة الألوان لتحقيق أقصى قيمة لشرط التدرج هذا. |
getMaxType() | InterpolationType | تحصل على نوع التقييد للحصول على أقصى قيمة لهذا الشرط من التدرج. |
getMaxValue() | String | تحصل على الحد الأقصى لقيمة شرط التدرج هذا. |
getMidColorObject() | Color | للحصول على مجموعة الألوان لقيمة نقطة المنتصف لشرط التدرج هذا. |
getMidType() | InterpolationType | تحصل على نوع الاحترار لقيمة النقطة المتوسطة لشرط التدرج هذا. |
getMidValue() | String | تحصل على قيمة النقطة المتوسطة لشرط التدرج هذا. |
getMinColorObject() | Color | للحصول على مجموعة الألوان ذات الحد الأدنى لقيمة شرط التدرج هذا. |
getMinType() | InterpolationType | تحصل على نوع الاستيفاء للحد الأدنى لقيمة شرط التدرج هذا. |
getMinValue() | String | تحصل على الحد الأدنى لقيمة شرط التدرج هذا. |
المستندات التفصيلية
getMaxColorObject()
للحصول على مجموعة الألوان لتحقيق أقصى قيمة لشرط التدرج هذا. عرض null
إذا لم يتم ضبط اللون.
تذكرة ذهاب وعودة
Color
— اللون الذي تم ضبطه لتحقيق أقصى قيمة لشرط التدرج هذا أو null
.
getMaxType()
تحصل على نوع التقييد للحصول على أقصى قيمة لهذا الشرط من التدرج. تعرض null
إذا لم يتم ضبط النوع الأقصى للتدرّج'؛
تذكرة ذهاب وعودة
InterpolationType
— نوع الاستيفاء للحصول على أقصى قيمة لشرط التدرج هذا أو null
getMaxValue()
تحصل على الحد الأقصى لقيمة شرط التدرج هذا. تعرض سلسلة فارغة إذا كانت InterpolationType
هي MAX
أو إذا لم يتم ضبط الحد الأقصى للقيمة.
تذكرة ذهاب وعودة
String
— الحد الأقصى للقيمة إذا تم تحديدها أو سلسلة فارغة
getMidColorObject()
للحصول على مجموعة الألوان لقيمة نقطة المنتصف لشرط التدرج هذا. عرض null
إذا لم يتم ضبط اللون.
تذكرة ذهاب وعودة
Color
— اللون الذي تم ضبطه لقيمة نقطة منتصف شرط التدرج هذا أو null
.
getMidType()
تحصل على نوع الاحترار لقيمة النقطة المتوسطة لشرط التدرج هذا. تعرض null
إذا لم يتم ضبط نوع التدرج المتدرّج'.
تذكرة ذهاب وعودة
InterpolationType
- نوع التضمين لقيمة نقطة منتصف هذا الشرط من التدرج أو null
getMidValue()
تحصل على قيمة النقطة المتوسطة لشرط التدرج هذا. يتم عرض سلسلة فارغة في حال عدم ضبط التدرج في منتصف القيمة.
تذكرة ذهاب وعودة
String
- قيمة النقطة المتوسطة أو سلسلة فارغة
getMinColorObject()
للحصول على مجموعة الألوان ذات الحد الأدنى لقيمة شرط التدرج هذا. عرض null
إذا لم يتم ضبط اللون.
تذكرة ذهاب وعودة
Color
— اللون الذي تم ضبطه للحد الأدنى من قيمة شرط التدرج هذا أو null
.
getMinType()
تحصل على نوع الاستيفاء للحد الأدنى لقيمة شرط التدرج هذا. تعرض null
إذا لم يتم ضبط نوع الحد الأدنى للتدرج.
تذكرة ذهاب وعودة
InterpolationType
— نوع الاستجواب للحد الأدنى لقيمة شرط التدرج هذا أو null
getMinValue()
تحصل على الحد الأدنى لقيمة شرط التدرج هذا. يتم عرض سلسلة فارغة إذا كانت InterpolationType
هي MIN
أو إذا لم يتم ضبط الحد الأدنى للقيمة.
تذكرة ذهاب وعودة
String
- الحد الأدنى للقيمة في حال تحديدها أو سلسلة فارغة