یک برش دهنده را نشان می دهد که برای فیلتر کردن محدوده ها، نمودارها و جداول محوری به روشی غیرهمکاری استفاده می شود. این کلاس حاوی متدهایی برای دسترسی و اصلاح برشکنندههای موجود است. برای ایجاد یک اسلایسر جدید، از 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
. این باید موقعیت 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()
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