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

Class PivotTable

גישה לטבלאות צירים ושינוי שלהן.

שיטות

שיטה	סוג הערך שמוחזר	תיאור קצר
`addCalculatedPivotValue(name, formula)`	`PivotValue`	יצירת ערך חדש בטבלת הצירים שמחושב מה-`formula` שצוין עם `name` שצוין.
`addColumnGroup(sourceDataColumn)`	`PivotGroup`	מגדיר קיבוץ חדש של עמודות בטבלת הצירים.
`addFilter(sourceDataColumn, filterCriteria)`	`PivotFilter`	יצירת מסנן צירים חדש לטבלת הצירים.
`addPivotValue(sourceDataColumn, summarizeFunction)`	`PivotValue`	הגדרת ערך חדש בטבלת הצירים עם ערך `summarizeFunction` שצוין.
`addRowGroup(sourceDataColumn)`	`PivotGroup`	מגדיר קיבוץ חדש של שורות צירים בטבלת הצירים.
`asDataSourcePivotTable()`	`DataSourcePivotTable`	הפונקציה מחזירה את טבלת הצירים בתור טבלת צירים של מקור נתונים אם היא מקושרת אל `DataSource` או אל `null` אחרת.
`getAnchorCell()`	`Range`	מחזירה את `Range` שמייצג את התא שבו טבלת הצירים מעוגנת.
`getColumnGroups()`	`PivotGroup[]`	מחזירה רשימה מסודרת של קבוצות העמודות בטבלת הצירים הזו.
`getFilters()`	`PivotFilter[]`	מחזירה רשימה מסודרת של המסננים בטבלת הצירים הזו.
`getPivotValues()`	`PivotValue[]`	מחזירה רשימה מסודרת של ערכי הצירים בטבלת צירים זו.
`getRowGroups()`	`PivotGroup[]`	מחזירה רשימה מסודרת של קבוצות השורות בטבלת הצירים הזו.
`getSourceDataRange()`	`Range`	מחזירה את טווח נתוני המקור שבו נבנת טבלת הצירים.
`getValuesDisplayOrientation()`	`Dimension`	מחזירה את השאלה אם ערכים מוצגים כשורות או כעמודות.
`remove()`	`void`	מחיקת טבלת הצירים הזאת.
`setValuesDisplayOrientation(dimension)`	`PivotTable`	הגדרת הפריסה של טבלת הצירים הזו להצגת ערכים כעמודות או כשורות.

תיעוד מפורט

`addCalculatedPivotValue(name, formula)`

יצירת ערך חדש בטבלת הצירים שמחושב מה-formula שצוין עם name שצוין.

פרמטרים

שם	תיאור	התיאור
`name`	`String`	השם של הערך המחושב בטבלת הציר.
`formula`	`String`	הנוסחה שמשמשת לחישוב הערך הזה.

החזרות

PivotValue – PivotValue שנוצר לאחרונה

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`addColumnGroup(sourceDataColumn)`

מגדיר קיבוץ חדש של עמודות בטבלת הצירים. הערך sourceDataColumn שצוין מציין את העמודה בנתוני המקור שקיבוץ הנתונים מבוסס עליהם.

פרמטרים

שם	תיאור	התיאור
`sourceDataColumn`	`Integer`	מספר העמודה שהקבוצה הזו מסכמת. האינדקס הזה מייצג את המספר המוחלט של העמודה בגיליון האלקטרוני. `1` מייצג את העמודה A, `2` מייצגת את עמודה B וכו'.

החזרות

PivotGroup – PivotGroup שנוצר לאחרונה

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`addFilter(sourceDataColumn, filterCriteria)`

יצירת מסנן צירים חדש לטבלת הצירים. הערך sourceDataColumn שצוין מציין את העמודה בנתוני המקור שהמסנן פועל בהם.

פרמטרים

שם	תיאור	התיאור
`sourceDataColumn`	`Integer`	מספר העמודה שהקבוצה הזו מסכמת. האינדקס הזה מייצג את המספר המוחלט של העמודה בגיליון האלקטרוני. `1` מייצג את העמודה A, `2` מייצגת את עמודה B וכו'.
`filterCriteria`	`FilterCriteria`	הקריטריונים של הסינון שבהם נעשה שימוש.

החזרות

PivotFilter – PivotFilter שנוצר לאחרונה

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`addPivotValue(sourceDataColumn, summarizeFunction)`

הגדרת ערך חדש בטבלת הצירים עם ערך summarizeFunction שצוין. הערך sourceDataColumn שצוין מציין את העמודה בנתוני המקור שעליה מבוסס הערך.

פרמטרים

שם	תיאור	התיאור
`sourceDataColumn`	`Integer`	מספר העמודה שהקבוצה הזו מסכמת. האינדקס הזה מייצג את המספר המוחלט של העמודה בגיליון האלקטרוני. `1` מייצג את העמודה A, `2` מייצגת את עמודה B וכו'.
`summarizeFunction`	`PivotTableSummarizeFunction`

החזרות

PivotValue – PivotValue שנוצר לאחרונה

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`addRowGroup(sourceDataColumn)`

מגדיר קיבוץ חדש של שורות צירים בטבלת הצירים. הערך sourceDataColumn שצוין מציין את העמודה בנתוני המקור שקיבוץ הנתונים מבוסס עליהם.

פרמטרים

שם	תיאור	התיאור
`sourceDataColumn`	`Integer`	מספר העמודה שהקבוצה הזו מסכמת. האינדקס הזה מייצג את המספר המוחלט של העמודה בגיליון האלקטרוני. `1` מייצג את העמודה A, `2` מייצגת את עמודה B וכו'.

החזרות

PivotGroup – PivotGroup שנוצר לאחרונה

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`asDataSourcePivotTable()`

הפונקציה מחזירה את טבלת הצירים בתור טבלת צירים של מקור נתונים אם היא מקושרת אל DataSource או אל null אחרת.

החזרות

DataSourcePivotTable - טבלת צירים של מקור נתונים.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`getAnchorCell()`

מחזירה את Range שמייצג את התא שבו טבלת הצירים מעוגנת.

החזרות

Range – תא העוגן של טבלת הצירים הזו

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`getColumnGroups()`

מחזירה רשימה מסודרת של קבוצות העמודות בטבלת הצירים הזו.

החזרות

PivotGroup[] - קבוצות העמודות בטבלת הצירים הזו

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`getFilters()`

מחזירה רשימה מסודרת של המסננים בטבלת הצירים הזו.

החזרות

PivotFilter[] – המסננים בטבלת הצירים הזאת

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`getPivotValues()`

מחזירה רשימה מסודרת של ערכי הצירים בטבלת צירים זו.

החזרות

PivotValue[] - ערכי הצירים שבטבלת הצירים הזו

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`getRowGroups()`

מחזירה רשימה מסודרת של קבוצות השורות בטבלת הצירים הזו.

החזרות

PivotGroup[] - קבוצות השורות בטבלת הצירים הזו

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`getSourceDataRange()`

מחזירה את טווח נתוני המקור שבו נבנת טבלת הצירים.

החזרות

Range – טווח נתוני המקור של טבלת הצירים הזו.

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`getValuesDisplayOrientation()`

מחזירה את השאלה אם ערכים מוצגים כשורות או כעמודות.

החזרות

Dimension – האם הערכים מוצגים כשורות או כעמודות

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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

`setValuesDisplayOrientation(dimension)`

הגדרת הפריסה של טבלת הצירים הזו להצגת ערכים כעמודות או כשורות.

פרמטרים

שם	תיאור	התיאור
`dimension`	`Dimension`	המאפיין שמציין איך להציג את הערכים בטבלת הצירים.

החזרות

PivotTable – טבלת הצירים לשרשורים

הרשאות

לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:

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