تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class PivotGroup

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

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`addManualGroupingRule(groupName, groupMembers)`	`PivotGroup`	إضافة قاعدة تجميع يدوي لهذه المجموعة المحورية.
`areLabelsRepeated()`	`Boolean`	يعرض ما إذا كان سيتم عرض التصنيفات كمكررة.
`clearGroupingRule()`	`PivotGroup`	إزالة أي قواعد تجميع من هذه المجموعة المحورية
`clearSort()`	`PivotGroup`	لإزالة أي ترتيب تم تطبيقه على هذه المجموعة.
`getDateTimeGroupingRule()`	`DateTimeGroupingRule`	عرض قاعدة تجميع التاريخ والوقت على المجموعة المحورية أو `null` إذا لم يكن هناك تاريخ ووقت تم تعيين قاعدة التجميع.
`getDimension()`	`Dimension`	تعرض ما إذا كانت مجموعة صفوف أو أعمدة.
`getGroupLimit()`	`PivotGroupLimit`	تعرض الحد الأقصى للمجموعة المحورية في المجموعة المحورية.
`getIndex()`	`Integer`	عرض فهرس هذه المجموعة المحورية بترتيب المجموعة الحالي.
`getPivotTable()`	`PivotTable`	تعرض مجموعة `PivotTable` التي تنتمي إليها هذه المجموعة.
`getSourceDataColumn()`	`Integer`	تعرض رقم عمود بيانات المصدر التي تلخّصها هذه المجموعة.
`getSourceDataSourceColumn()`	`DataSourceColumn`	تعرض عمود مصدر البيانات الذي تعمل عليه المجموعة المحورية.
`hideRepeatedLabels()`	`PivotGroup`	يؤدي هذا الإجراء إلى إخفاء التصنيفات المتكرّرة لهذه المجموعة.
`isSortAscending()`	`Boolean`	عرض `true` إذا كان الترتيب تصاعديًا، وعرض `false` إذا كان نظام الترتيب هو تنازليًا.
`moveToIndex(index)`	`PivotGroup`	نقل هذه المجموعة إلى الموضع المحدّد في القائمة الحالية لمجموعات الصفوف أو الأعمدة
`remove()`	`void`	لإزالة هذه المجموعة المحورية من الجدول.
`removeManualGroupingRule(groupName)`	`PivotGroup`	يزيل قاعدة التجميع اليدوي التي تتضمن `groupName` المحددة.
`resetDisplayName()`	`PivotGroup`	لإعادة ضبط الاسم المعروض لهذه المجموعة في الجدول المحوري على قيمته التلقائية.
`setDateTimeGroupingRule(dateTimeGroupingRuleType)`	`PivotGroup`	لضبط قاعدة تجميع التاريخ والوقت على المجموعة المحورية.
`setDisplayName(name)`	`PivotGroup`	لضبط الاسم المعروض لهذه المجموعة في الجدول المحوري.
`setGroupLimit(countLimit)`	`PivotGroup`	لضبط الحد الأقصى للمجموعة المحورية في المجموعة المحورية.
`setHistogramGroupingRule(minValue, maxValue, intervalSize)`	`PivotGroup`	تحدد قاعدة تجميع مدرج تكراري لهذه المجموعة المحورية.
`showRepeatedLabels()`	`PivotGroup`	عندما يكون هناك أكثر من تجميع للصفوف أو الأعمدة، فإن هذه الطريقة تعرض تصنيف هذه التجميع لكل إدخال في التجميع اللاحق.
`showTotals(showTotals)`	`PivotGroup`	تحدد ما إذا كان سيتم عرض القيم الإجمالية لهذه المجموعة المحورية في الجدول.
`sortAscending()`	`PivotGroup`	لضبط ترتيب الفرز تصاعديًا.
`sortBy(value, oppositeGroupValues)`	`PivotGroup`	لترتيب هذه المجموعة حسب `PivotValue` المحددة للقيم من `oppositeGroupValues`.
`sortDescending()`	`PivotGroup`	لضبط ترتيب الفرز تنازليًا.
`totalsAreShown()`	`Boolean`	لعرض ما إذا كانت القيم الإجمالية معروضة حاليًا لهذه المجموعة المحورية.

الوثائق التفصيلية

`addManualGroupingRule(groupName, groupMembers)`

إضافة قاعدة تجميع يدوي لهذه المجموعة المحورية.

المعلمات

الاسم	النوع	الوصف
`groupName`	`String`	اسم قاعدة التجميع هذه.
`groupMembers`	`Object[]`	القيم التي تم تضمينها في قاعدة التجميع هذه.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`areLabelsRepeated()`

يعرض ما إذا كان سيتم عرض التصنيفات كمكررة.

الإرجاع

Boolean — true في حال تكرار التصنيفات في الحالات الأخرى false.

التفويض

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

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

`clearGroupingRule()`

إزالة أي قواعد تجميع من هذه المجموعة المحورية

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`clearSort()`

لإزالة أي ترتيب تم تطبيقه على هذه المجموعة.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`getDateTimeGroupingRule()`

عرض قاعدة تجميع التاريخ والوقت على المجموعة المحورية أو null إذا لم يكن هناك تاريخ ووقت تم تعيين قاعدة التجميع.

الإرجاع

DateTimeGroupingRule — قاعدة تجميع التاريخ والوقت.

التفويض

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

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

`getDimension()`

تعرض ما إذا كانت مجموعة صفوف أو أعمدة.

الإرجاع

Dimension: السمة التي تمثّل نوع هذه المجموعة

التفويض

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

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

`getGroupLimit()`

تعرض الحد الأقصى للمجموعة المحورية في المجموعة المحورية. عرض null في حال عدم توفّر حد أقصى للمجموعة المحورية تم تعيينها.

الإرجاع

PivotGroupLimit - الحد الأقصى للمجموعة المحورية

التفويض

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

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

`getIndex()`

عرض فهرس هذه المجموعة المحورية بترتيب المجموعة الحالي.

الإرجاع

Integer - فهرس المجموعة المحورية

التفويض

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

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

`getPivotTable()`

تعرض مجموعة PivotTable التي تنتمي إليها هذه المجموعة.

الإرجاع

PivotTable - الجدول المحوري الذي تنتمي إليه هذه المجموعة.

التفويض

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

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

`getSourceDataColumn()`

تعرض رقم عمود بيانات المصدر التي تلخّصها هذه المجموعة. ويستند هذا الفهرس إلى الرقم 1، إذا تلخِّص هذه المجموعة بيانات المصدر في العمود "A" لجدول البيانات تُرجع هذه الطريقة 1.

الإرجاع

Integer: رقم عمود بيانات المصدر

التفويض

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

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

`getSourceDataSourceColumn()`

تعرض عمود مصدر البيانات الذي تعمل عليه المجموعة المحورية. عرض null إذا كان المحور لا يكون الجدول {DataSourcePivotTableApi}.

الإرجاع

DataSourceColumn: عمود مصدر البيانات الذي تعمل عليه المجموعة المحورية.

التفويض

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

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

`hideRepeatedLabels()`

يؤدي هذا الإجراء إلى إخفاء التصنيفات المتكرّرة لهذه المجموعة. إذا كانت التصنيفات مخفية، فسيؤدّي ذلك إلى عدم التنفيذ. إذا تم استدعاء هذه الطريقة قبل وجود مجموعات متعددة من الصفوف أو الأعمدة، فعندما تكون نتيجة تتم إضافة تصنيفات متكررة، ويتم إخفاء التصنيفات المتكررة.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`isSortAscending()`

عرض true إذا كان الترتيب تصاعديًا، وعرض false إذا كان نظام الترتيب هو تنازليًا.

الإرجاع

Boolean — true إذا كان نظام الترتيب تصاعديًا

التفويض

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

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

`moveToIndex(index)`

نقل هذه المجموعة إلى الموضع المحدّد في القائمة الحالية لمجموعات الصفوف أو الأعمدة هذه الفهارس تستند إلى 0. على سبيل المثال، إذا كان يجب نقل هذه المجموعة إلى الموضع الأول، فإن هذا باستخدام 0.

المعلمات

الاسم	النوع	الوصف
`index`	`Integer`	الفهرس المطلوب نقل هذه المجموعة إليه.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`removeManualGroupingRule(groupName)`

يزيل قاعدة التجميع اليدوي التي تتضمن groupName المحددة.

المعلمات

الاسم	النوع	الوصف
`groupName`	`String`	اسم قاعدة التجميع المطلوب إزالتها.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`resetDisplayName()`

لإعادة ضبط الاسم المعروض لهذه المجموعة في الجدول المحوري على قيمته التلقائية.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`setDateTimeGroupingRule(dateTimeGroupingRuleType)`

لضبط قاعدة تجميع التاريخ والوقت على المجموعة المحورية.

لإزالة القاعدة، استخدِم clearGroupingRule().

المعلمات

الاسم	النوع	الوصف
`dateTimeGroupingRuleType`	`DateTimeGroupingRuleType`	نوع القاعدة المطلوب ضبطها.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`setDisplayName(name)`

لضبط الاسم المعروض لهذه المجموعة في الجدول المحوري.

المعلمات

الاسم	النوع	الوصف
`name`	`String`	الاسم المعروض المطلوب ضبطه

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة

التفويض

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

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

`setGroupLimit(countLimit)`

لضبط الحد الأقصى للمجموعة المحورية في المجموعة المحورية. لا تتوفّر هذه العملية إلا لـ DataSourcePivotTable.

المعلمات

الاسم	النوع	الوصف
`countLimit`	`Integer`	الحد الأقصى لعدد الصفوف أو الأعمدة المطلوب ضبطها. يجب أن تكون موجبة.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`setHistogramGroupingRule(minValue, maxValue, intervalSize)`

تحدد قاعدة تجميع مدرج تكراري لهذه المجموعة المحورية. تنظم قاعدة المدرّج التكراري القيم في عمود البيانات المصدر إلى مجموعات ذات حجم ثابت. يتم وضع جميع القيم من minValue إلى maxValue في مجموعات بحجم interval. كل القيم أقل من minValue يتم وضعها في مجموعة واحدة، كما هي الحال مع جميع القيم الأكبر من maxValue.

المعلمات

الاسم	النوع	الوصف
`minValue`	`Integer`	الحد الأدنى لقيمة العناصر المراد وضعها في مجموعات. القيم أقل من هذه يتم دمجها في مجموعة واحدة.
`maxValue`	`Integer`	الحد الأقصى لقيمة العناصر التي سيتم وضعها في المجموعات. القيم أكبر من هذه يتم دمجها في مجموعة واحدة.
`intervalSize`	`Integer`

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`showRepeatedLabels()`

عندما يكون هناك أكثر من تجميع للصفوف أو الأعمدة، فإن هذه الطريقة تعرض تصنيف هذه التجميع لكل إدخال في التجميع اللاحق. إذا تم تكرار التصنيفات بالفعل، فسيتم بيئة مستقلة إذا تم استدعاء هذه الطريقة قبل وجود مجموعات متعددة للصفوف أو الأعمدة، فعندما تتم إضافة مجموعات إضافية، تظهر التصنيفات المتكررة.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`showTotals(showTotals)`

تحدد ما إذا كان سيتم عرض القيم الإجمالية لهذه المجموعة المحورية في الجدول.

المعلمات

الاسم	النوع	الوصف
`showTotals`	`Boolean`	تحديد ما إذا كان سيتم إظهار الإجماليات أم لا

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`sortAscending()`

لضبط ترتيب الفرز تصاعديًا.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`sortBy(value, oppositeGroupValues)`

لترتيب هذه المجموعة حسب PivotValue المحددة للقيم من oppositeGroupValues.

// Sorts the item group by the "SUM of Quantity" pivot value for the specified salespersons.
var sheet = SpreadsheetApp.getActiveSheet();
var pivotTable = sheet.getPivotTables()[0];
var itemGroup = pivotTable.getRowGroups()[0];
var sumQuantityValue = pivotTable.getPivotValues()[0];
itemGroup.sortBy(sumQuantityValue, ['Beth', 'Amir', 'Devyn']);

المعلمات

الاسم	النوع	الوصف
`value`	`PivotValue`	القيمة المحورية المطلوب الترتيب حسبها.
`oppositeGroupValues`	`Object[]`	قيم المجموعة المحورية المعاكسة (مجموعة أعمدة إذا كان فرزها مجموعة صفوف أو مجموعة صفوف في حال ترتيب مجموعة أعمدة) والتي تُستخدم للترتيب. ترتيب تحدد هذه القيم الأسبقية لكسر التعادل.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`sortDescending()`

لضبط ترتيب الفرز تنازليًا.

الإرجاع

PivotGroup - المجموعة المحورية للسلسلة.

التفويض

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

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

`totalsAreShown()`

لعرض ما إذا كانت القيم الإجمالية معروضة حاليًا لهذه المجموعة المحورية.

الإرجاع

Boolean — true في حال عرض القيم الإجمالية لهذه المجموعة المحورية، في الحالات الأخرى false

التفويض

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

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