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

انظر أيضًا