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