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.
const sheet = SpreadsheetApp.getActiveSheet();
const rules = sheet.getConditionalFormatRules();
for (let i = 0; i < rules.length; i++) {
  const gradient = rules[i].getGradientCondition();

  const minColor = gradient.getMinColorObject().asRgbColor().asHexString();
  const minType = gradient.getMinType();
  const minValue = gradient.getMinValue();
  const midColor = gradient.getMidColorObject().asRgbColor().asHexString();
  const midType = gradient.getMidType();
  const midValue = gradient.getMidValue();
  const maxColor = gradient.getMaxColorObject().asRgbColor().asHexString();
  const maxType = gradient.getMaxType();
  const maxValue = gradient.getMaxValue();

  Logger.log(`The conditional format gradient information for rule ${i}:
    MinColor ${minColor}, MinType ${minType}, MinValue ${minValue},
    MidColor ${midColor}, MidType ${midType}, MidValue ${midValue},
    MaxColor ${maxColor}, MaxType ${maxType}, MaxValue ${maxValue}`);
}

الطُرق

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

الطُرق المتوقّفة