Class Group

ग्रुप

स्प्रेडशीट ग्रुप को ऐक्सेस और उनमें बदलाव कर सकता है. ग्रुप, लगातार पंक्तियों या कॉलम के इंटरवल के बीच का संबंध होता है. पंक्तियों या कॉलम को छिपाने/दिखाने के लिए, इन्हें एक यूनिट के तौर पर बड़ा या छोटा किया जा सकता है. हर ग्रुप में, ग्रुप से ठीक पहले या बाद में (सेटिंग के हिसाब से) मौजूद लाइन या कॉलम पर कंट्रोल टॉगल होता है. इससे पूरे ग्रुप को बड़ा या छोटा किया जा सकता है.

किसी ग्रुप की डेप्थ से पता चलता है कि ग्रुप को नेस्टेड करने के लिए किस लेवल पर रखा गया है. साथ ही, यह भी पता चलता है कि कितने बड़े ग्रुप में यह ग्रुप शामिल है. किसी ग्रुप की छोटी की गई स्थिति से पता चलता है कि पैरंट ग्रुप को बड़ा करने के बाद, ग्रुप को छोटा किया जाना चाहिए या बड़ा किया जाना चाहिए. इसके अलावा, जब किसी ग्रुप को छोटा या बड़ा किया जाता है, तब ग्रुप में मौजूद पंक्तियों या कॉलम को छिपाया जाता है या दिखाया जाता है. हालांकि, किसी ग्रुप को छोटा किए जाने की स्थिति के बावजूद, अलग-अलग पंक्तियों या कॉलम को छिपाया या दिखाया जा सकता है.

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
collapse()Groupइस ग्रुप को छोटा करता है.
expand()Groupइस ग्रुप को बड़ा करता है.
getControlIndex()Integerइस ग्रुप के कंट्रोल टॉगल का इंडेक्स दिखाता है.
getDepth()Integerइस ग्रुप की डेप्थ दिखाता है.
getRange()Rangeयह फ़ंक्शन, उस रेंज को दिखाता है जिसमें यह ग्रुप मौजूद है.
isCollapsed()Booleanअगर इस ग्रुप को छोटा किया गया है, तो रिस्पॉन्स के तौर पर true मिलता है.
remove()voidइस ग्रुप को शीट से हटाता है. इससे range की ग्रुप डेप्थ एक कम हो जाती है.

ज़्यादा जानकारी वाला दस्तावेज़

collapse()

इस ग्रुप को छोटा करता है. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const 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()

इस ग्रुप को बड़ा करता है. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const 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()

इस ग्रुप के कंट्रोल टॉगल का इंडेक्स दिखाता है. यह रेंज से ठीक पहले का इंडेक्स होता है. ऐसा तब होता है, जब कंट्रोल टॉगल को ग्रुप से पहले दिखाया जाता है. इसके अलावा, यह रेंज के ठीक बाद का इंडेक्स होता है. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
sheet.setRowGroupControlAfter(true);
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);

// Returns 4
const controlIndex = group.getControlIndex();

वापसी का टिकट

Integer — इस ग्रुप का कंट्रोल टॉगल इंडेक्स.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getDepth()

इस ग्रुप की डेप्थ दिखाता है. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);

// Returns 1 if the group is at depth 1.
const depth = group.getDepth();

वापसी का टिकट

Integer — इस ग्रुप की गहराई.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

getRange()

यह फ़ंक्शन, उस रेंज को दिखाता है जिसमें यह ग्रुप मौजूद है. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
let range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const 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 मिलता है. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
const range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);

// Returns true if the group is collapsed.
const isCollapsed = group.isCollapsed();

वापसी का टिकट

Boolean — true अगर इस ग्रुप को छोटा किया गया है, तो false दिखाता है.

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

remove()

इस ग्रुप को शीट से हटाता है. इससे range की ग्रुप डेप्थ एक कम हो जाती है. इससे अन्य ग्रुप में बदलाव हो सकता है. इसे कॉल करने के बाद, ग्रुप ऑब्जेक्ट का इस्तेमाल नहीं किया जा सकता. 

const sheet = SpreadsheetApp.getActiveSpreadsheet().getSheets()[0];
let range = sheet.getRange('2:3');
range.shiftRowGroupDepth(1);
const group = sheet.getRowGroup(2, 1);

// Removes this group
range = group.remove();

अनुमति देना

इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट के लिए, इनमें से एक या उससे ज़्यादा स्कोप के साथ अनुमति लेना ज़रूरी है:

  • https://www.googleapis.com/auth/spreadsheets.currentonly
  • https://www.googleapis.com/auth/spreadsheets

इन्हें भी देखें