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 - أدنى قيمة إذا كانت محددة أو سلسلة فارغة

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