تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

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

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

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

`getMaxColor()`

تمّ إيقاف هذا العمود نهائيًا. تم استبداله بـ getMaxColorObject()

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

الإرجاع

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

`getMidColor()`

تمّ إيقاف هذا العمود نهائيًا. تم استبداله بـ getMidColorObject()

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

الإرجاع

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

`getMinColor()`

تمّ إيقاف هذا العمود نهائيًا. تم استبداله بـ getMinColorObject()

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

الإرجاع

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