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الصيغة المستخدَمة لاحتساب هذه القيمة.

الإرجاع

PivotValue: العنصر PivotValue الذي تم إنشاؤه حديثًا

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

addColumnGroup(sourceDataColumn)

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

المعلمات

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

الإرجاع

PivotGroup: العنصر PivotGroup الذي تم إنشاؤه حديثًا

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

addFilter(sourceDataColumn, filterCriteria)

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

المعلمات

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

الإرجاع

PivotFilter: العنصر PivotFilter الذي تم إنشاؤه حديثًا

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

addPivotValue(sourceDataColumn, summarizeFunction)

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

المعلمات

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

الإرجاع

PivotValue: العنصر PivotValue الذي تم إنشاؤه حديثًا

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

addRowGroup(sourceDataColumn)

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

المعلمات

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

الإرجاع

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