يمكنك الوصول إلى شروط التدرج (الألوان) في 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
- الحد الأدنى للقيمة في حال تحديدها أو سلسلة فارغة