الوصول إلى مجموعات جداول البيانات وتعديلها المجموعات هي ارتباط بين فاصل من صفوف أو أعمدة متجاورة يمكن توسيعها أو تصغيرها كوحدة لإخفاء/عرض الصفوف أو الأعمدة. تحتوي كل مجموعة على مفتاح تبديل للتحكّم في الصف أو العمود قبل المجموعة مباشرةً أو بعدها (حسب الإعدادات) الذي يمكنه توسيع المجموعة بأكملها أو تصغيرها.
يشير عمق مجموعة إلى الموضع المتداخل للمجموعة وعدد المجموعات الأكبر التي تحتوي عليها. تشير الحالة المصغّرة للمجموعة إلى ما إذا كان يجب أن تظل المجموعة مصغَّرة أو موسّعة بعد توسيع المجموعة الرئيسية. إضافةً إلى ذلك، عند تصغير المجموعة أو توسيعها، تكون الصفوف أو الأعمدة داخل المجموعة مخفية أو مرئية، على الرغم من إمكانية إخفاء الصفوف أو الأعمدة الفردية أو ضبطها على أنها مرئية بصرف النظر عن حالة تصغيرها.
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
collapse() | Group | لتصغير هذه المجموعة. |
expand() | Group | توسيع هذه المجموعة |
getControlIndex() | Integer | يتم عرض فهرس تبديل عنصر التحكّم لهذه المجموعة. |
getDepth() | Integer | تعرض عمق هذه المجموعة. |
getRange() | Range | عرض النطاق الذي تتوفر فيه هذه المجموعة. |
isCollapsed() | Boolean | تعرض هذه الدالة true في حال تصغير هذه المجموعة. |
remove() | void | تتم إزالة هذه المجموعة من الورقة، ما يؤدي إلى تقليل عمق المجموعة في range بمقدار واحد. |
الوثائق التفصيلية
collapse()
لتصغير هذه المجموعة.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Collapses this group. group.collapse();
استرجاع الكرة
Group
— هذه المجموعة للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
expand()
توسيع هذه المجموعة
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Expands this group. group.expand();
استرجاع الكرة
Group
— هذه المجموعة للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getControlIndex()
يتم عرض فهرس تبديل عنصر التحكّم لهذه المجموعة. هذا هو الفهرس قبل النطاق مباشرةً عندما يظهر زر تبديل التحكم قبل المجموعة أو الفهرس بعد النطاق مباشرةً.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; sheet.setRowGroupControlAfter(true); var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Returns 4 var controlIndex = group.getControlIndex();
استرجاع الكرة
Integer
- فهرس تبديل عنصر التحكّم لهذه المجموعة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getDepth()
تعرض عمق هذه المجموعة.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Returns 1 if the group is at depth 1. var depth = group.getDepth();
استرجاع الكرة
Integer
- عدد الأعضاء في هذه المجموعة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
getRange()
عرض النطاق الذي تتوفر فيه هذه المجموعة.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(1, 1); // Returns the range 2:3 if the group is over rows 2:3 range = group.getRange();
استرجاع الكرة
Range
- النطاق الذي توجد به المجموعة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
isCollapsed()
تعرض هذه الدالة true
في حال تصغير هذه المجموعة.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Returns true if the group is collapsed. var isCollapsed = group.isCollapsed();
استرجاع الكرة
Boolean
: true
في حال تصغير هذه المجموعة، ويتم عرض false
في الحالات الأخرى
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets
remove()
تتم إزالة هذه المجموعة من الورقة، ما يؤدي إلى تقليل عمق المجموعة في range
بمقدار واحد. قد يؤدي ذلك إلى تعديل مجموعات أخرى. بعد استدعاء هذا، يصبح كائن المجموعة غير صالح للاستخدام.
var sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0]; var range = sheet.getRange(2:3); range.shiftRowGroupDepth(1); var group = sheet.getRowGroup(2, 1); // Removes this group var range = group.remove();
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets