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 العمود "أ"، 2 يمثّل العمود "ب"، وما إلى ذلك.

الإرجاع

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

التفويض

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

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

---

addFilter(sourceDataColumn, filterCriteria)

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

المعلمات

الاسم	النوع	الوصف
sourceDataColumn	Integer	رقم العمود الذي تلخّصه هذه المجموعة. يمثّل هذا الفهرس الرقم المطلق للعمود في جدول البيانات، حيث يمثّل 1 العمود "أ"، 2 يمثّل العمود "ب"، وما إلى ذلك.
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 العمود "أ"، 2 يمثّل العمود "ب"، وما إلى ذلك.
summarizeFunction	PivotTableSummarizeFunction

الإرجاع

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

التفويض

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

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

---

addRowGroup(sourceDataColumn)

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

المعلمات

الاسم	النوع	الوصف
sourceDataColumn	Integer	رقم العمود الذي تلخّصه هذه المجموعة. يمثّل هذا الفهرس الرقم المطلق للعمود في جدول البيانات، حيث يمثّل 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)

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

المعلمات

الاسم	النوع	الوصف
dimension	Dimension	السمة التي تشير إلى كيفية عرض قيم الجدول المحوري

الإرجاع

PivotTable - الجدول المحوري لإنشاء سلاسل

التفويض

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

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