Class GradientCondition

GradientCondition

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

طرق متوقّفة نهائيًا