Class Slicer

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

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

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
getBackgroundColorObject()	Color	عرض الخلفية Color لفلتر نطاق البيانات.
getColumnPosition()	Integer	يتم عرض موضع العمود (بالنسبة إلى نطاق بيانات فلتر نطاق البيانات) الذي يتم تطبيق الفلتر عليه في فلتر نطاق بيانات، أو عرض null إذا لم يتم ضبط موضع العمود.
getContainerInfo()	ContainerInfo	الحصول على معلومات عن مكان وضع فلتر نطاق البيانات في ورقة البيانات
getFilterCriteria()	FilterCriteria	تعرِض معايير الفلتر الخاص بفلتر نطاق البيانات، أو 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	عرض لون خلفية فلتر نطاق البيانات في ترميز CSS (مثل '#ffffff').

الوثائق التفصيلية

getBackgroundColorObject()

عرض الخلفية Color لفلتر نطاق البيانات.

استرجاع الكرة

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

التفويض

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

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

---

getColumnPosition()

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

استرجاع الكرة

Integer — موضع العمود لهذا فلتر نطاق البيانات

التفويض

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

• 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 — معايير الفلتر في فلتر نطاق البيانات هذا

التفويض

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

• 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)

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

المَعلمات

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

استرجاع الكرة

Slicer - هذا فلتر نطاق البيانات هذا مخصّص للتسلسل.

التفويض

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

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

---

setBackgroundColor(color)

لضبط لون خلفية فلتر نطاق البيانات. تؤدي قيمة null إلى إعادة ضبط لون الخلفية.

المَعلمات

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

استرجاع الكرة

Slicer - هذا فلتر نطاق البيانات هذا مخصّص للتسلسل.

التفويض

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

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

---

setBackgroundColorObject(color)

لضبط الخلفية Color في فلتر نطاق البيانات. تعمل قيمة null على إعادة ضبط لون الخلفية.

المَعلمات

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

استرجاع الكرة

Slicer - هذا فلتر نطاق البيانات هذا مخصّص للتسلسل.

التفويض

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

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

---

setColumnFilterCriteria(columnPosition, filterCriteria)

تحدِّد هذه السياسة فهرس العمود ومعايير الفلترة الخاصة بفلتر نطاق البيانات. تعيد قيمة null ضبط فلتر فلتر نطاق البيانات.

المَعلمات

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

استرجاع الكرة

Slicer - هذا فلتر نطاق البيانات هذا مخصّص للتسلسل.

التفويض

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

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

---

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

لضبط الموضع الذي يظهر فيه فلتر نطاق البيانات على الورقة. فهارس موضع الارتساء والعمود مفهرسة باستخدام رقم 1.

المَعلمات

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

استرجاع الكرة

Slicer - هذا فلتر نطاق البيانات هذا مخصّص للتسلسل.

التفويض

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

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

---

setRange(rangeApi)

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

المَعلمات

الاسم	Type	الوصف
rangeApi	Range	النطاق الجديد لفلتر نطاق البيانات هذا

استرجاع الكرة

Slicer - هذا فلتر نطاق البيانات هذا مخصّص للتسلسل.

التفويض

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

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

---

setTitle(title)

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

المَعلمات

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

استرجاع الكرة

Slicer - هذا فلتر نطاق البيانات هذا مخصّص للتسلسل.

التفويض

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

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

---

setTitleHorizontalAlignment(horizontalAlignment)

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

المَعلمات

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

استرجاع الكرة

Slicer - هذا فلتر نطاق البيانات هذا مخصّص للتسلسل.

التفويض

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

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

---

setTitleTextStyle(textStyle)

لضبط نمط النص في فلتر نطاق بيانات.

المَعلمات

الاسم	Type	الوصف
textStyle	TextStyle	نمط النص الجديد لعنوان فلتر نطاق بيانات

استرجاع الكرة

Slicer - هذا فلتر نطاق البيانات هذا مخصّص للتسلسل.

التفويض

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

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

الطرق المتوقّفة نهائيًا

getBackgroundColor()

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

عرض لون خلفية فلتر نطاق البيانات في ترميز CSS (مثل '#ffffff').

استرجاع الكرة

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

التفويض

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

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