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|nullتعرض هذه السمة مجموعة الألوان التي تم ضبطها للحد الأقصى لقيمة شرط التدرّج هذا.
getMaxType()InterpolationType|nullتعرض هذه السمة نوع الاستيفاء للحد الأقصى لقيمة شرط التدرّج هذا.
getMaxValue()Stringتعرض هذه الطريقة الحد الأقصى لقيمة شرط التدرّج هذا.
getMidColorObject()Color|nullتعرض هذه السمة مجموعة الألوان للقيمة المتوسطة لشرط التدرّج هذا.
getMidType()InterpolationType|nullتعرض هذه السمة نوع الاستيفاء لقيمة نقطة الوسط في شرط التدرّج هذا.
getMidValue()Stringتعرض هذه السمة قيمة نقطة المنتصف لشرط التدرّج هذا.
getMinColorObject()Color|nullتعرض هذه السمة مجموعة الألوان التي تم ضبطها للحد الأدنى لقيمة شرط التدرّج هذا.
getMinType()InterpolationType|nullتعرض هذه السمة نوع الاستيفاء للحد الأدنى لقيمة شرط التدرّج هذا.
getMinValue()Stringتعرض هذه السمة الحد الأدنى لقيمة شرط التدرّج هذا.

مستندات تفصيلية

getMaxColorObject()

تعرض هذه السمة مجموعة الألوان التي تم ضبطها للحد الأقصى لقيمة شرط التدرّج هذا. تعرض null إذا لم يتم ضبط اللون.

الإرجاع

Color|null: اللون الذي تم ضبطه للحد الأقصى لقيمة شرط التدرّج هذا أو null


getMaxType()

تعرض هذه السمة نوع الاستيفاء للحد الأقصى لقيمة شرط التدرّج هذا. تعرِض هذه السمة القيمة null إذا لم يتم ضبط نوع الحد الأقصى للتدرّج.

الإرجاع

InterpolationType|null: نوع الاستيفاء للحد الأقصى لقيمة شرط التدرّج هذا أو null


getMaxValue()

تعرض هذه الطريقة الحد الأقصى لقيمة شرط التدرّج هذا. تعرض هذه الدالة سلسلة فارغة إذا كانت قيمة InterpolationType هي MAX أو إذا لم يتم ضبط الحد الأقصى للقيمة.

الإرجاع

String: الحد الأقصى للقيمة إذا تم تحديده أو سلسلة فارغة


getMidColorObject()

تعرض هذه السمة مجموعة الألوان للقيمة المتوسطة لشرط التدرّج هذا. تعرض null إذا لم يتم ضبط اللون.

الإرجاع

Color|null: مجموعة الألوان المحدّدة للقيمة المتوسطة لشرط التدرّج هذا أو null


getMidType()

تعرض هذه السمة نوع الاستيفاء لقيمة نقطة الوسط في شرط التدرّج هذا. تعرِض هذه السمة القيمة null إذا لم يتم ضبط نوع التدرّج اللوني المتوسط.

الإرجاع

InterpolationType|null: نوع الاستيفاء لقيمة نقطة المنتصف لشرط التدرّج هذا أو null.


getMidValue()

تعرض هذه السمة قيمة نقطة المنتصف لشرط التدرّج هذا. تعرِض هذه السمة سلسلة فارغة إذا لم يتم ضبط قيمة منتصف التدرّج.

الإرجاع

String: قيمة نقطة الوسط أو سلسلة فارغة


getMinColorObject()

تعرض هذه السمة مجموعة الألوان التي تم ضبطها للحد الأدنى لقيمة شرط التدرّج هذا. تعرض null إذا لم يتم ضبط اللون.

الإرجاع

Color|null: اللون الذي تم ضبطه للحد الأدنى لقيمة شرط التدرّج هذا أو null.


getMinType()

تعرض هذه السمة نوع الاستيفاء للحد الأدنى لقيمة شرط التدرّج هذا. تعرِض القيمة null إذا لم يتم ضبط الحد الأدنى لنوع التدرّج.

الإرجاع

InterpolationType|null: نوع الاستيفاء للحد الأدنى لقيمة شرط التدرّج هذا أو null


getMinValue()

تعرض هذه السمة الحد الأدنى لقيمة شرط التدرّج هذا. تعرض هذه الدالة سلسلة فارغة إذا كانت قيمة InterpolationType هي MIN أو إذا لم يتم ضبط الحد الأدنى للقيمة.

الإرجاع

String: الحد الأدنى للقيمة إذا تم تحديده أو سلسلة فارغة

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