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

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