דף זה תורגם על ידי Cloud Translation API.

Class Slicer

מייצג כלי סינון, שמשמש לסינון טווחים, תרשימים וטבלאות צירים באופן לא שיתופי. הכיתה הזו מכילה שיטות לגישה ולשינוי של כלי חיתוך קיימים. כדי ליצור חותך חדש, משתמשים ב-Sheet.insertSlicer(range, anchorRowPos, anchorColPos).

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`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