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تحدد نمط النص في فلتر نطاق البيانات.

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

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

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

تذكرة ذهاب وعودة

Booleantrue إذا تم تطبيق فلتر نطاق البيانات هذا على الجداول المحورية، وبخلاف ذلك، 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)

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

المعلّمات

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

تذكرة ذهاب وعودة

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

التفويض

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

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

setBackgroundColor(color)

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

المعلّمات

الاسمالنوعالوصف
colorStringلون الخلفية الجديد لأداة فلترة البيانات في تدوين CSS (مثل '#ffffff')

تذكرة ذهاب وعودة

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

التفويض

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

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

setBackgroundColorObject(color)

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

المعلّمات

الاسمالنوعالوصف
colorColorلون الخلفية الجديد لأداة فلترة البيانات

تذكرة ذهاب وعودة

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

التفويض

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

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

setColumnFilterCriteria(columnPosition, filterCriteria)

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

المعلّمات

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

تذكرة ذهاب وعودة

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

التفويض

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

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

setPosition(anchorRowPos, anchorColPos, offsetX, offsetY)

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

المعلّمات

الاسمالنوعالوصف
anchorRowPosIntegerتم إرساء الجانب العلوي من فلتر نطاق البيانات في هذا الصف.
anchorColPosIntegerتم ربط الجانب العلوي من فلتر نطاق البيانات في هذه المجموعة.
offsetXIntegerالإزاحة الأفقية من زاوية الخلية بالبكسل.
offsetYIntegerالإزاحة الرأسية من زاوية الخلية بالبكسل.

تذكرة ذهاب وعودة

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

التفويض

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

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

setRange(rangeApi)

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

المعلّمات

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

تذكرة ذهاب وعودة

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

التفويض

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

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

setTitle(title)

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

المعلّمات

الاسمالنوعالوصف
titleStringالعنوان الجديد لفلتر نطاق البيانات.

تذكرة ذهاب وعودة

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

التفويض

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

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

setTitleHorizontalAlignment(horizontalAlignment)

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

المعلّمات

الاسمالنوعالوصف
horizontalAlignmentStringالمحاذاة الأفقية الجديدة لعنوان الشريحة هذا.

تذكرة ذهاب وعودة

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

التفويض

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

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

setTitleTextStyle(textStyle)

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

المعلّمات

الاسمالنوعالوصف
textStyleTextStyleنمط النص الجديد لعنوان فلتر نطاق البيانات.

تذكرة ذهاب وعودة

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

التفويض

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

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

الطرق التي تم إيقافها نهائيًا