Class Slicer

أداة تقسيم

يمثّل فلتر نطاق بيانات، والذي يُستخدَم لفلترة النطاقات والرسوم البيانية والجداول المحورية بطريقة غير تعاونية. تحتوي هذه الفئة على methods للوصول إلى أقسام الشرائح الحالية وتعديلها. لإنشاء أداة تقسيم جديدة، استخدِم 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 في حال عدم ضبط موضع العمود. يجب أن يكون هذا هو الموضع الذي يستند إلى الفهرس 1 للعمود، تمامًا مثل الفلتر.

الإرجاع

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)

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

المعلمات

الاسم	النوع	الوصف
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 إذا لم يتم ضبط أي لون.

التفويض

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

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