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

همچنین ببینید