Class Group

تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.
تجميع

الوصول إلى مجموعات جداول البيانات وتعديلها. المجموعات هي رابط بين فاصل من الصفوف أو الأعمدة المتجاورة يمكن توسيعها أو تصغيرها كوحدة لإخفاء/إظهار الصفوف أو الأعمدة. تحتوي كل مجموعة على مفتاح تحكّم في الصف أو العمود مباشرةً قبل أو بعد المجموعة. (اعتمادًا على الإعدادات) التي يمكنها توسيع المجموعة أو تصغيرها بالكامل.

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

الطُرق

الطريقةنوع الإرجاعوصف قصير
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();

تذكرة ذهاب وعودة

Booleantrue إذا تم تصغير هذه المجموعة، تعرض 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

راجع أيضًا