Class 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 إذا لم يتم ضبط النوع الأقصى للتدرّج&#39؛

تذكرة ذهاب وعودة

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

الطرق التي تم إيقافها نهائيًا