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 المحدّد.

المعلّمات

الاسمالنوعالوصف
nameStringاسم هذه القيمة المحورية المحسوبة.
formulaStringالصيغة المستخدمة لحساب هذه القيمة.

تذكرة ذهاب وعودة

PivotValuePivotValue الذي تم إنشاؤه حديثًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

addColumnGroup(sourceDataColumn)

تحديد تجميع أعمدة محوري جديد في الجدول المحوري. يشير sourceDataColumn المحدّد إلى العمود في البيانات المصدر الذي تستند إليه هذه المجموعة.

المعلّمات

الاسمالنوعالوصف
sourceDataColumnIntegerعدد الأعمدة التي تلخّصها هذه المجموعة. ويمثّل هذا الفهرس العدد المطلق للعمود في جدول البيانات، ويمثل 1 العمود و"القصة" و"2" الذي يمثّل العمود "ب" وما إلى ذلك.

تذكرة ذهاب وعودة

PivotGroupPivotGroup الذي تم إنشاؤه حديثًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

addFilter(sourceDataColumn, filterCriteria)

يؤدي هذا الخيار إلى إنشاء فلتر محوري جديد للجدول المحوري. يشير sourceDataColumn المحدّد إلى العمود في البيانات المصدر التي يعمل عليها هذا الفلتر.

المعلّمات

الاسمالنوعالوصف
sourceDataColumnIntegerعدد الأعمدة التي تلخّصها هذه المجموعة. ويمثّل هذا الفهرس العدد المطلق للعمود في جدول البيانات، ويمثل 1 العمود و"القصة" و"2" الذي يمثّل العمود "ب" وما إلى ذلك.
filterCriteriaFilterCriteriaمعايير الفلترة المستخدَمة لإجراء الفلترة.

تذكرة ذهاب وعودة

PivotFilterPivotFilter الذي تم إنشاؤه حديثًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

addPivotValue(sourceDataColumn, summarizeFunction)

تحديد قيمة محورية جديدة في الجدول المحوري باستخدام summarizeFunction المحدّد. وتشير السمة sourceDataColumn المحدّدة إلى العمود في البيانات المصدر الذي تستند إليه هذه القيمة.

المعلّمات

الاسمالنوعالوصف
sourceDataColumnIntegerعدد الأعمدة التي تلخّصها هذه المجموعة. ويمثّل هذا الفهرس العدد المطلق للعمود في جدول البيانات، ويمثل 1 العمود و"القصة" و"2" الذي يمثّل العمود "ب" وما إلى ذلك.
summarizeFunctionPivotTableSummarizeFunction

تذكرة ذهاب وعودة

PivotValuePivotValue الذي تم إنشاؤه حديثًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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

addRowGroup(sourceDataColumn)

تحديد تجميع صفوف محورية جديدة في الجدول المحوري. يشير sourceDataColumn المحدّد إلى العمود في البيانات المصدر الذي تستند إليه هذه المجموعة.

المعلّمات

الاسمالنوعالوصف
sourceDataColumnIntegerعدد الأعمدة التي تلخّصها هذه المجموعة. ويمثّل هذا الفهرس العدد المطلق للعمود في جدول البيانات، ويمثل 1 العمود و"القصة" و"2" الذي يمثّل العمود "ب" وما إلى ذلك.

تذكرة ذهاب وعودة

PivotGroupPivotGroup الذي تم إنشاؤه حديثًا

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

  • 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