Class Banding

التدرّج

الوصول إلى التنسيقات المتناوبة وتعديلها، وهي أنماط الألوان المطبَّقة على صفوف أو أعمدة نطاق يتألف كل تلوين من نطاق ومجموعة ألوان للصفوف والأعمدة والرؤوس والتذييلات.

الطُرق

الطريقةنوع القيمة التي يتم إرجاعهاوصف قصير
copyTo(range)Bandingينسخ هذا النطاق إلى نطاق آخر.
getFirstColumnColorObject()Color|nullتعرض هذه السمة لون العمود البديل الأول في التخطيط، أو null إذا لم يتم ضبط أي لون.
getFirstRowColorObject()Color|nullتعرض هذه السمة لون الصف البديل الأول، أو null إذا لم يتم ضبط أي لون.
getFooterColumnColorObject()Color|nullتعرض هذه السمة لون العمود الأخير في التخطيط الشريطي، أو null إذا لم يتم ضبط أي لون.
getFooterRowColorObject()Color|nullتعرض هذه السمة لون الصف الأخير في التخطيط، أو null إذا لم يتم ضبط أي لون.
getHeaderColumnColorObject()Color|nullتعرِض هذه السمة لون العمود الأول في التخطيط الشريطي، أو null إذا لم يتم ضبط أي لون.
getHeaderRowColorObject()Color|nullتعرِض هذه السمة لون صف العناوين أو null إذا لم يتم ضبط أي لون.
getRange()Rangeتعرِض هذه الدالة النطاق الخاص بهذا التصنيف.
getSecondColumnColorObject()Color|nullتعرِض هذه السمة لون العمود الثاني البديل في التخطيط الشريطي، أو null إذا لم يتم ضبط أي لون.
getSecondRowColorObject()Color|nullتعرض هذه السمة لون الصف الثاني البديل، أو null إذا لم يتم ضبط أي لون.
remove()voidتتم إزالة هذا التباين.
setFirstColumnColor(color)Bandingتضبط هذه السمة لون العمود الأول الذي يتم تبديله.
setFirstColumnColorObject(color)Bandingتضبط هذه السمة لون العمود الأول البديل في التخطيط.
setFirstRowColor(color)Bandingتضبط هذه السمة لون الصف الأول الذي يتم تبديله.
setFirstRowColorObject(color)Bandingتضبط هذه السمة لون الصف الأول البديل في التخطيط.
setFooterColumnColor(color)Bandingيحدّد لون العمود الأخير.
setFooterColumnColorObject(color)Bandingتضبط هذه السمة لون العمود الأخير في التخطيط المخطّط.
setFooterRowColor(color)Bandingتضبط هذه السمة لون الصف الأخير.
setFooterRowColorObject(color)Bandingتضبط هذه السمة لون صف التذييل في التخطيط المخطط.
setHeaderColumnColor(color)Bandingتضبط هذه السمة لون عمود العنوان.
setHeaderColumnColorObject(color)Bandingتضبط هذه السمة لون عمود العنوان.
setHeaderRowColor(color)Bandingتضبط هذه السمة لون صف العناوين.
setHeaderRowColorObject(color)Bandingتضبط هذه السمة لون صف العناوين.
setRange(range)Bandingتضبط هذه السمة النطاق الخاص بهذا التجميع في فئات.
setSecondColumnColor(color)Bandingتضبط هذه السمة لون العمود الثاني الذي يتم تبديله.
setSecondColumnColorObject(color)Bandingتضبط هذه السمة لون العمود الثاني البديل في التخطيط الشريطي.
setSecondRowColor(color)Bandingتضبط هذه السمة لون الصف الثاني الذي يتم تبديله.
setSecondRowColorObject(color)Bandingتضبط هذه السمة اللون الثاني المتناوب في التخطيط الشريطي.

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

copyTo(range)

ينسخ هذا النطاق إلى نطاق آخر.

المعلمات

الاسمالنوعالوصف
rangeRangeالنطاق المطلوب نسخ هذا التلوين المخطّط إليه

الإرجاع

Banding: يشير إلى النطاق الجديد.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFirstColumnColorObject()

تعرض هذه السمة لون العمود البديل الأول في التخطيط، أو null إذا لم يتم ضبط أي لون.

الإرجاع

Color|null: لون العمود الأول المتناوب في التخطيط الشريطي، أو null إذا لم يتم ضبط أي لون.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFirstRowColorObject()

تعرض هذه السمة لون الصف البديل الأول، أو null إذا لم يتم ضبط أي لون.

الإرجاع

Color|null: لون الصف الأول المتناوب في التخطيط الشريطي، أو null إذا لم يتم ضبط أي لون.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFooterColumnColorObject()

تعرض هذه السمة لون العمود الأخير في التخطيط الشريطي، أو null إذا لم يتم ضبط أي لون.

الإرجاع

‫Color|null: لون العمود الأخير في التظليل، أو null إذا لم يتم ضبط أي لون

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getFooterRowColorObject()

تعرض هذه السمة لون الصف الأخير في التخطيط، أو null إذا لم يتم ضبط أي لون.

الإرجاع

Color|null: لون صف التذييل في التخطيط المخطّط، أو null إذا لم يتم ضبط أي لون

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getHeaderColumnColorObject()

تعرِض هذه السمة لون العمود الأول في التخطيط الشريطي، أو null إذا لم يتم ضبط أي لون.

الإرجاع

Color|null: لون العمود الأول في التخطيط المخطّط، أو null إذا لم يتم ضبط أي لون.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getHeaderRowColorObject()

تعرِض هذه السمة لون صف العناوين أو null إذا لم يتم ضبط أي لون.

الإرجاع

Color|null: لون صف العناوين، ويعرض null إذا لم يتم ضبط أي لون.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange()

تعرِض هذه الدالة النطاق الخاص بهذا التصنيف.

الإرجاع

Range: نطاق هذه الفئة

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSecondColumnColorObject()

تعرِض هذه السمة لون العمود الثاني البديل في التخطيط الشريطي، أو null إذا لم يتم ضبط أي لون.

الإرجاع

‫Color|null: لون العمود الثاني البديل في التخطيط الشريطي، أو null إذا لم يتم ضبط أي لون.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getSecondRowColorObject()

تعرض هذه السمة لون الصف الثاني البديل، أو null إذا لم يتم ضبط أي لون.

الإرجاع

‫Color|null: لون الصف الثاني البديل في التخطيط الشريطي، أو null إذا لم يتم ضبط أي لون

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

تتم إزالة هذا التباين.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFirstColumnColor(color)

تضبط هذه السمة لون العمود الأول الذي يتم تبديله.

المعلمات

الاسمالنوعالوصف
colorStringرمز اللون بتنسيق CSS (مثل '#ffffff' أو 'white')، أو null لإزالة اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFirstColumnColorObject(color)

تضبط هذه السمة لون العمود الأول البديل في التخطيط.

المعلمات

الاسمالنوعالوصف
colorColorلون العمود الأول الجديد البديل في التخطيط الشريطي، ويؤدي ضبطه على null إلى محو اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFirstRowColor(color)

تضبط هذه السمة لون الصف الأول الذي يتم تبديله.

المعلمات

الاسمالنوعالوصف
colorStringرمز اللون بتنسيق CSS (مثل '#ffffff' أو 'white')، أو null لإزالة اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFirstRowColorObject(color)

تضبط هذه السمة لون الصف الأول البديل في التخطيط.

المعلمات

الاسمالنوعالوصف
colorColorاللون الأول الجديد المتناوب في التخطيط المخطط، ويؤدي ضبطه على null إلى محو اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFooterColumnColor(color)

يحدّد لون العمود الأخير.

المعلمات

الاسمالنوعالوصف
colorStringرمز اللون بتنسيق CSS (مثل '#ffffff' أو 'white')، أو null لإزالة اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFooterColumnColorObject(color)

تضبط هذه السمة لون العمود الأخير في التخطيط المخطّط.

المعلمات

الاسمالنوعالوصف
colorColorاللون الجديد للعمود الأخير في التظليل، ويؤدي ضبطه على null إلى محو اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFooterRowColor(color)

تضبط هذه السمة لون الصف الأخير.

المعلمات

الاسمالنوعالوصف
colorStringرمز اللون بتنسيق CSS (مثل '#ffffff' أو 'white')، أو null لإزالة اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setFooterRowColorObject(color)

تضبط هذه السمة لون صف التذييل في التخطيط المخطط.

المعلمات

الاسمالنوعالوصف
colorColorلون صف التذييل الجديد، ويؤدي ضبط القيمة على null إلى محو اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHeaderColumnColor(color)

تضبط هذه السمة لون عمود العنوان.

المعلمات

الاسمالنوعالوصف
colorStringرمز اللون بتنسيق CSS (مثل '#ffffff' أو 'white')، أو null لإزالة اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHeaderColumnColorObject(color)

تضبط هذه السمة لون عمود العنوان.

المعلمات

الاسمالنوعالوصف
colorColorلون عمود العنوان الجديد، ويؤدي ضبطه على null إلى محو اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHeaderRowColor(color)

تضبط هذه السمة لون صف العناوين.

المعلمات

الاسمالنوعالوصف
colorStringرمز اللون بتنسيق CSS (مثل '#ffffff' أو 'white')، أو null لإزالة اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setHeaderRowColorObject(color)

تضبط هذه السمة لون صف العناوين.

المعلمات

الاسمالنوعالوصف
colorColorلون صف العنوان الجديد، ويؤدي ضبطه على null إلى محو اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setRange(range)

تضبط هذه السمة النطاق الخاص بهذا التجميع في فئات.

المعلمات

الاسمالنوعالوصف
rangeRangeالنطاق الجديد لهذه الفئة

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setSecondColumnColor(color)

تضبط هذه السمة لون العمود الثاني الذي يتم تبديله.

المعلمات

الاسمالنوعالوصف
colorStringرمز اللون بتنسيق CSS (مثل '#ffffff' أو 'white')، أو null لإزالة اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setSecondColumnColorObject(color)

تضبط هذه السمة لون العمود الثاني البديل في التخطيط الشريطي.

المعلمات

الاسمالنوعالوصف
colorColorاللون الثاني الجديد للعمود المتناوب في التخطيط الشريطي، ويؤدي ضبطه على null إلى محو اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setSecondRowColor(color)

تضبط هذه السمة لون الصف الثاني الذي يتم تبديله.

المعلمات

الاسمالنوعالوصف
colorStringرمز اللون بتنسيق CSS (مثل '#ffffff' أو 'white')، أو null لإزالة اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

setSecondRowColorObject(color)

تضبط هذه السمة اللون الثاني المتناوب في التخطيط الشريطي.

المعلمات

الاسمالنوعالوصف
colorColorاللون الثاني الجديد المتناوب في التخطيط الشريطي، ويؤدي ضبطه على null إلى محو اللون.

الإرجاع

Banding: هذا النطاق مخصّص للربط.

التفويض

تتطلّب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على إذن باستخدام نطاق واحد أو أكثر من النطاقات التالية:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

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