Class PivotTable

PivotTable

الوصول إلى الجداول المحورية وتعديلها

الطُرق

الطريقةنوع القيمة التي تم إرجاعهاوصف قصير
addCalculatedPivotValue(name, formula)PivotValueتنشئ هذه الدالة قيمة محورية جديدة في الجدول المحوري يتم احتسابها من formula المحدّد باستخدام name المحدّد.
addColumnGroup(sourceDataColumn)PivotGroupتحدّد هذه السمة تجميعًا جديدًا لأعمدة محورية في الجدول المحوري.
addFilter(sourceDataColumn, filterCriteria)PivotFilterتُنشئ هذه الدالة فلترًا محوريًا جديدًا للجدول المحوري.
addPivotValue(sourceDataColumn, summarizeFunction)PivotValueتحدّد هذه السمة قيمة محورية جديدة في الجدول المحوري باستخدام summarizeFunction المحدّد.
addRowGroup(sourceDataColumn)PivotGroupتحدّد هذه السمة تجميعًا جديدًا لصفوف الجدول المحوري.
asDataSourcePivotTable()DataSourcePivotTable|nullتعرض هذه الدالة الجدول المحوري كجدول محوري لمصدر بيانات إذا كان الجدول المحوري مرتبطًا بـ 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|null: جدول محوري لمصدر البيانات

التفويض

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

  • 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