الوصول إلى مجموعات جداول البيانات وتعديلها المجموعات هي ارتباط بين فاصل زمني متتالي صفوف أو أعمدة يمكن توسيعها أو تصغيرها كوحدة لإخفاء أو إظهار الصفوف أو الأعمدة. يتوفّر في كل مجموعة مفتاح تحكّم في الصف أو العمود قبل المجموعة أو بعدها مباشرةً. (حسب الإعدادات) التي يمكنها توسيع المجموعة ككل أو تصغيرها.
يشير عمق مجموعة إلى الموضع المدمَج فيها وعدد العناصر الأكبر تحتوي على المجموعة. تشير الحالة المصغّرة للمجموعة إلى ما إذا كانت المجموعة أن تظل مصغّرة أو موسّعة بعد توسيع مجموعة رئيسية. بالإضافة إلى ذلك، في صفحة أو وقت تصغير المجموعة أو توسيعها، كانت الصفوف أو الأعمدة داخل المجموعة مخفية أو مرئية، على الرغم من أن الصفوف أو الأعمدة الفردية يمكن أن تكون مخفية أو يمكن رؤيتها بغض النظر عن حالة مصغَّرة.
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
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