Class Slicer

فلتر نطاق البيانات

يمثّل هذا النوع فلتر نطاق بيانات، ويُستخدم لفلترة النطاقات والرسوم البيانية والجداول المحورية بطريقة غير تعاونية. تحتوي هذه الفئة على طرق للوصول إلى أدوات التقطيع الحالية وتعديلها. لإنشاء فلتر نطاق بيانات جديد، استخدِم Sheet.insertSlicer(range, anchorRowPos, anchorColPos).

الطُرق

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
getBackgroundColorObject()	Color|null	إرجاع الخلفية Color من أداة التقطيع
getColumnPosition()	Integer|null	تعرض هذه السمة موضع العمود (بالنسبة إلى نطاق بيانات فلتر نطاق البيانات) الذي يتم تطبيق الفلتر عليه في فلتر نطاق البيانات، أو null إذا لم يتم ضبط موضع العمود.
getContainerInfo()	ContainerInfo	تعرض هذه الدالة معلومات حول موضع أداة التقطيع في ورقة البيانات.
getFilterCriteria()	FilterCriteria|null	تعرض هذه الدالة معايير الفلتر الخاصة بفلتر نطاق البيانات، أو null إذا لم يتم ضبط معايير الفلتر.
getRange()	Range	تعرض هذه الدالة نطاق البيانات الذي يتم تطبيق فلتر نطاق البيانات عليه.
getTitle()	String	تعرض هذه الدالة عنوان أداة التقطيع.
getTitleHorizontalAlignment()	String	تعرض هذه السمة المحاذاة الأفقية للعنوان.
getTitleTextStyle()	TextStyle	تعرض هذه الدالة نمط النص لعنوان أداة التقطيع.
isAppliedToPivotTables()	Boolean	تعرض ما إذا كان يتم تطبيق فلتر نطاق البيانات المحدّدة على الجداول المحورية.
remove()	void	يحذف مقسّم البيانات.
setApplyToPivotTables(applyToPivotTables)	Slicer	تضبط هذه السمة ما إذا كان يجب تطبيق فلتر نطاق البيانات على الجداول المحورية في ورقة البيانات.
setBackgroundColor(color)	Slicer	تضبط هذه السمة لون خلفية أداة التقطيع.
setBackgroundColorObject(color)	Slicer	تضبط هذه السمة خلفية أداة التقطيع.Color
setColumnFilterCriteria(columnPosition, filterCriteria)	Slicer	تضبط هذه السمة فهرس العمود ومعايير الفلترة الخاصة بأداة التقطيع.
setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)	Slicer	تضبط هذه السمة موضع أداة التقطيع على ورقة البيانات.
setRange(rangeApi)	Slicer	تضبط هذه السمة نطاق البيانات الذي يتم تطبيق فلتر نطاق البيانات عليه.
setTitle(title)	Slicer	تضبط هذه السمة عنوان أداة التقطيع.
setTitleHorizontalAlignment(horizontalAlignment)	Slicer	تضبط هذه السمة المحاذاة الأفقية للعنوان في أداة التقطيع.
setTitleTextStyle(textStyle)	Slicer	تضبط هذه السمة نمط النص الخاص بأداة التقطيع.

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

الطريقة	نوع القيمة التي تم إرجاعها	وصف قصير
getBackgroundColor()	String|null	تعرِض هذه السمة لون خلفية فلتر نطاق البيانات بتنسيق CSS (مثل ‎#ffffff).

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

getBackgroundColorObject()

إرجاع الخلفية Color من أداة التقطيع

الإرجاع

Color|null: لون خلفية أداة التقطيع هذه تعرِض null إذا لم يتم ضبط أي لون.

التفويض

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

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

---

getColumnPosition()

تعرض هذه السمة موضع العمود (بالنسبة إلى نطاق بيانات فلتر نطاق البيانات) الذي يتم تطبيق الفلتر عليه في فلتر نطاق البيانات، أو null إذا لم يتم ضبط موضع العمود. يجب أن يكون هذا الرقم هو موضع العمود المستند إلى الفهرس 1، على غرار الفلتر.

الإرجاع

Integer|null: موضع العمود الخاص بأداة التقطيع هذه

التفويض

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

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

---

getContainerInfo()

تعرض هذه الدالة معلومات حول موضع أداة التقطيع في ورقة البيانات.

الإرجاع

ContainerInfo: عنصر يحتوي على موضع حاوية أداة التقطيع.

التفويض

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

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

---

getFilterCriteria()

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

الإرجاع

FilterCriteria|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

---

getTitle()

تعرض هذه الدالة عنوان أداة التقطيع.

الإرجاع

String: أداة التقطيع هذه مخصّصة للربط.

التفويض

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

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

---

getTitleHorizontalAlignment()

تعرض هذه السمة المحاذاة الأفقية للعنوان.

الإرجاع

String: المحاذاة الأفقية لعنوان أداة التقطيع هذه.

التفويض

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

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

---

getTitleTextStyle()

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

الإرجاع

TextStyle: نمط نص عنوان أداة التقطيع هذه.

التفويض

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

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

---

isAppliedToPivotTables()

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

الإرجاع

‫Boolean: true إذا تم تطبيق أداة التقطيع هذه على الجداول المحورية، وإلا false.

التفويض

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

• 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

---

setApplyToPivotTables(applyToPivotTables)

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

المعلمات

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

الإرجاع

Slicer: أداة التقطيع هذه مخصّصة للربط.

التفويض

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

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

---

setBackgroundColor(color)

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

المعلمات

الاسم	النوع	الوصف
color	String	لون الخلفية الجديد لأداة التقطيع هذه بتنسيق CSS (مثل ‎#ffffff).

الإرجاع

Slicer: أداة التقطيع هذه مخصّصة للربط.

التفويض

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

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

---

setBackgroundColorObject(color)

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

المعلمات

الاسم	النوع	الوصف
color	Color	لون الخلفية الجديد لفلتر نطاق البيانات هذا.

الإرجاع

Slicer: أداة التقطيع هذه مخصّصة للربط.

التفويض

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

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

---

setColumnFilterCriteria(columnPosition, filterCriteria)

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

المعلمات

الاسم	النوع	الوصف
columnPosition	Integer	موضع العمود الجديد لأداة التقطيع هذه.
filterCriteria	FilterCriteria	معايير الفلتر الجديدة الخاصة بأداة التقطيع هذه.

الإرجاع

Slicer: أداة التقطيع هذه مخصّصة للربط.

التفويض

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

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

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

تضبط هذه السمة موضع أداة التقطيع على ورقة البيانات. فهارس موضع الصف والعمود الأساسيَّين مفهرسة بدءًا من 1.

المعلمات

الاسم	النوع	الوصف
anchorRowPos	Integer	يتم تثبيت الجانب العلوي من أداة التقطيع في هذا الصف.
anchorColPos	Integer	يتم تثبيت الجانب العلوي من أداة التقطيع في هذا العمود.
offsetX	Integer	الإزاحة الأفقية من زاوية الخلية بالبكسل
offsetY	Integer	الإزاحة العمودية من زاوية الخلية بالبكسل

الإرجاع

Slicer: أداة التقطيع هذه مخصّصة للربط.

التفويض

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

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

---

setRange(rangeApi)

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

المعلمات

الاسم	النوع	الوصف
rangeApi	Range	النطاق الجديد لأداة التقطيع هذه.

الإرجاع

Slicer: أداة التقطيع هذه مخصّصة للربط.

التفويض

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

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

---

setTitle(title)

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

المعلمات

الاسم	النوع	الوصف
title	String	العنوان الجديد لأداة التقطيع هذه.

الإرجاع

Slicer: أداة التقطيع هذه مخصّصة للربط.

التفويض

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

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

---

setTitleHorizontalAlignment(horizontalAlignment)

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

المعلمات

الاسم	النوع	الوصف
horizontalAlignment	String	المحاذاة الأفقية الجديدة لعنوان أداة التقطيع هذه.

الإرجاع

Slicer: أداة التقطيع هذه مخصّصة للربط.

التفويض

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

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

---

setTitleTextStyle(textStyle)

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

المعلمات

الاسم	النوع	الوصف
textStyle	TextStyle	نمط النص الجديد لعنوان أداة التقطيع

الإرجاع

Slicer: أداة التقطيع هذه مخصّصة للربط.

التفويض

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

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

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

getBackgroundColor()

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

تعرِض هذه السمة لون خلفية فلتر نطاق البيانات بتنسيق CSS (مثل ‎#ffffff).

الإرجاع

String|null: لون خلفية أداة التقطيع هذه تعرِض null إذا لم يتم ضبط أي لون.

التفويض

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

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