Class PivotTable

טבלתצירים

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

Methods

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

פרמטרים

שםסוגתיאור
nameStringהשם של ערך הציר המחושב הזה.
formulaStringהנוסחה שמשמש לחישוב הערך הזה.

חזרה

PivotValue – ה-PivotValue שנוצר

אישור

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

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

addColumnGroup(sourceDataColumn)

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

פרמטרים

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

חזרה

PivotGroup – ה-PivotGroup שנוצר

אישור

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

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

addFilter(sourceDataColumn, filterCriteria)

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

פרמטרים

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

חזרה

PivotFilter – ה-PivotFilter שנוצר

אישור

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

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

addPivotValue(sourceDataColumn, summarizeFunction)

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

פרמטרים

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

חזרה

PivotValue – ה-PivotValue שנוצר

אישור

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

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

addRowGroup(sourceDataColumn)

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

פרמטרים

שםסוגתיאור
sourceDataColumnIntegerהמספר של העמודה שהקבוצה הזו מסכם. האינדקס הזה מייצג את המספר המוחלט של העמודה בגיליון האלקטרוני. הערך 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)

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

פרמטרים

שםסוגתיאור
dimensionDimensionהמאפיין שמציין איך להציג את ערכי הציר.

חזרה

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

אישור

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

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