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();

استرجاع الكرة

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

يمكن أيضًا مراجعة