الوصول إلى الجداول المحورية وتعديلها.
الطُرق
| الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
|---|---|---|
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 المحددة.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
name | String | اسم هذه القيمة المحورية المحسوبة. |
formula | String | الصيغة المستخدمة لحساب هذه القيمة. |
استرجاع الكرة
PivotValue — الإصدار الجديد من PivotValue
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addColumnGroup(sourceDataColumn)
تحدِّد هذه الدالة تجميعًا جديدًا للأعمدة المحورية في الجدول المحوري. يشير sourceDataColumn المحدّد إلى العمود في البيانات المصدر التي تستند إليها هذه المجموعة.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
sourceDataColumn | Integer | رقم العمود الذي تلخصه هذه المجموعة. يمثّل هذا الفهرس
العدد المطلق للعمود في جدول البيانات، ويمثّل 1 العمود "A"،
و2 الذي يمثّل العمود B، إلخ. |
استرجاع الكرة
PivotGroup — الإصدار الجديد من PivotGroup
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addFilter(sourceDataColumn, filterCriteria)
تنشئ فلترًا محوريًا جديدًا للجدول المحوري. يشير sourceDataColumn المحدّد إلى العمود في بيانات المصدر التي يعمل عليها هذا الفلتر.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
sourceDataColumn | Integer | رقم العمود الذي تلخصه هذه المجموعة. يمثّل هذا الفهرس
العدد المطلق للعمود في جدول البيانات، ويمثّل 1 العمود "A"،
و2 الذي يمثّل العمود B، إلخ. |
filterCriteria | FilterCriteria | معايير الفلترة المستخدَمة لإجراء الفلترة |
استرجاع الكرة
PivotFilter — الإصدار الجديد من PivotFilter
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addPivotValue(sourceDataColumn, summarizeFunction)
تحدّد قيمة محورية جديدة في الجدول المحوري باستخدام summarizeFunction المحدّدة. وتشير
القيمة المحدّدة للسمة sourceDataColumn إلى العمود في بيانات المصدر التي تستند إليها هذه القيمة.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
sourceDataColumn | Integer | رقم العمود الذي تلخصه هذه المجموعة. يمثّل هذا الفهرس
العدد المطلق للعمود في جدول البيانات، ويمثّل 1 العمود "A"،
و2 الذي يمثّل العمود B، إلخ. |
summarizeFunction | PivotTableSummarizeFunction |
استرجاع الكرة
PivotValue — الإصدار الجديد من PivotValue
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets
addRowGroup(sourceDataColumn)
تحدِّد هذه السمة تجميع صفوف محورية جديدة في الجدول المحوري. يشير sourceDataColumn المحدّد إلى العمود في البيانات المصدر التي تستند إليها هذه المجموعة.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
sourceDataColumn | Integer | رقم العمود الذي تلخصه هذه المجموعة. يمثّل هذا الفهرس
العدد المطلق للعمود في جدول البيانات، ويمثّل 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)
ضبط تنسيق هذا الجدول المحوري لعرض القيم كأعمدة أو صفوف.
المَعلمات
| الاسم | Type | الوصف |
|---|---|---|
dimension | Dimension | السمة التي تشير إلى كيفية عرض القيم المحورية. |
استرجاع الكرة
PivotTable: الجدول المحوري للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly -
https://www.googleapis.com/auth/spreadsheets