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.
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	تعرض هذه السمة الحد الأدنى لقيمة شرط التدرّج هذا.

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

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
getMaxColor()	String	تعرض هذه السمة مجموعة الألوان التي تم ضبطها للحد الأقصى لقيمة شرط التدرّج هذا.
getMidColor()	String	تعرض هذه السمة مجموعة الألوان للقيمة المتوسطة لشرط التدرّج هذا.
getMinColor()	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: الحد الأدنى للقيمة إذا تم تحديده أو سلسلة فارغة

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

getMaxColor()

تمّت إزالة هذا العمود. تم استبداله بـ "getMaxColorObject()"

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

الإرجاع

String: لون تم ضبطه للحد الأقصى لقيمة شرط التدرّج هذا أو سلسلة فارغة

---

getMidColor()

تمّت إزالة هذا العمود. تم استبداله بـ "getMidColorObject()"

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

الإرجاع

String: مجموعة الألوان المحدّدة للقيمة المتوسطة لشرط التدرّج هذا أو سلسلة فارغة

---

getMinColor()

تمّت إزالة هذا العمود. تم استبداله بـ "getMinColorObject()"

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

الإرجاع

String: اللون الذي تم ضبطه للحد الأدنى لقيمة شرط التدرّج اللوني هذا أو سلسلة فارغة