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

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