Class Selection

चुना गया

ऐक्टिव शीट में, फ़िलहाल चुने गए सेल को ऐक्सेस करता है. चुने गए सेल, शीट में उपयोगकर्ता के हाइलाइट किए गए सेल का सेट होता है. ये सेल, बगल में मौजूद रेंज के अलावा किसी अन्य रेंज में भी हो सकते हैं. चुनी गई सेल में से एक सेल, मौजूदा सेल होती है. उपयोगकर्ता का फ़ोकस इसी सेल पर होता है. Google Sheets के यूज़र इंटरफ़ेस (यूआई) में, मौजूदा सेल को गहरे रंग के बॉर्डर से हाइलाइट किया जाता है. 

const activeSheet = SpreadsheetApp.getActiveSheet();
const rangeList = activeSheet.getRangeList(['A1:B4', 'D1:E4']);
rangeList.activate();

const selection = activeSheet.getSelection();
// Current Cell: D1
console.log(`Current Cell: ${selection.getCurrentCell().getA1Notation()}`);
// Active Range: D1:E4
console.log(`Active Range: ${selection.getActiveRange().getA1Notation()}`);
// Active Ranges: A1:B4, D1:E4
const ranges = selection.getActiveRangeList().getRanges();
for (let i = 0; i < ranges.length; i++) {
  console.log(`Active Ranges: ${ranges[i].getA1Notation()}`);
}
console.log(`Active Sheet: ${selection.getActiveSheet().getName()}`);

तरीके

तरीकारिटर्न टाइपसंक्षिप्त विवरण
getActiveRange()Range|nullयह फ़ंक्शन, चालू शीट में चुनी गई रेंज दिखाता है. अगर कोई रेंज चालू नहीं है, तो यह null दिखाता है.
getActiveRangeList()RangeList|nullयह फ़ंक्शन, ऐक्टिव शीट में मौजूद ऐक्टिव रेंज की सूची दिखाता है. अगर कोई ऐक्टिव रेंज मौजूद नहीं है, तो यह null दिखाता है.
getActiveSheet()Sheetयह फ़ंक्शन, स्प्रेडशीट में मौजूद ऐक्टिव शीट दिखाता है.
getCurrentCell()Range|nullयह फ़ंक्शन, किसी ऐक्टिव रेंज में चुनी गई मौजूदा (हाइलाइट की गई) सेल या null दिखाता है. अगर कोई मौजूदा सेल नहीं है, तो यह null दिखाता है.
getNextDataRange(direction)Range|nullcurrent cell और active range से शुरू होकर, दिए गए दिशा में आगे बढ़ता है. इसके बाद, एक ऐसी अडजस्ट की गई रेंज दिखाता है जिसमें रेंज के सही किनारे को next data cell को कवर करने के लिए शिफ़्ट किया गया है. हालांकि, इसमें मौजूदा सेल को अब भी शामिल किया जाता है.

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

getActiveRange()

यह फ़ंक्शन, चालू शीट में चुनी गई रेंज दिखाता है. अगर कोई रेंज चालू नहीं है, तो यह null दिखाता है. अगर एक से ज़्यादा रेंज चुनी जाती हैं, तो यह तरीका सिर्फ़ आखिरी चुनी गई रेंज दिखाता है. 

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const activeRange = selection.getActiveRange();

वापसी का टिकट

Range|null — ऐक्टिव रेंज.

अनुमति देना

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

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

getActiveRangeList()

यह फ़ंक्शन, ऐक्टिव शीट में मौजूद ऐक्टिव रेंज की सूची दिखाता है. अगर कोई ऐक्टिव रेंज मौजूद नहीं है, तो यह null दिखाता है.

अगर सिर्फ़ एक रेंज चुनी गई है, तो यह getActiveRange() कॉल की तरह काम करता है. 

const sheet = SpreadsheetApp.getActiveSheet();
// Returns the list of active ranges.
const activeRangeList = sheet.getActiveRangeList();

वापसी का टिकट

RangeList|null — ऐक्टिव रेंज की सूची.

अनुमति देना

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

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

getActiveSheet()

यह फ़ंक्शन, स्प्रेडशीट में मौजूद ऐक्टिव शीट दिखाता है. 

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
const activeSheet = selection.getActiveSheet();

वापसी का टिकट

Sheet — स्प्रेडशीट में मौजूद ऐक्टिव शीट.

अनुमति देना

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

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

getCurrentCell()

यह फ़ंक्शन, किसी ऐक्टिव रेंज में चुनी गई मौजूदा (हाइलाइट की गई) सेल या null दिखाता है. अगर कोई मौजूदा सेल नहीं है, तो यह null दिखाता है. 

const selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
// Returns the current highlighted cell in the one of the active ranges.
const currentCell = selection.getCurrentCell();

वापसी का टिकट

Range|null — मौजूदा सेल.

अनुमति देना

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

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

getNextDataRange(direction)

current cell और active range से शुरू होकर, दिए गए दिशा में आगे बढ़ता है. इसके बाद, एक ऐसी अडजस्ट की गई रेंज दिखाता है जिसमें रेंज के सही किनारे को next data cell को कवर करने के लिए शिफ़्ट किया गया है. हालांकि, इसमें मौजूदा सेल को अब भी शामिल किया जाता है. अगर ऐक्टिव रेंज, दिशा के dimension के साथ असीमित है, तो ओरिजनल ऐक्टिव रेंज दिखती है. अगर कोई मौजूदा सेल या ऐक्टिव रेंज नहीं है, तो null दिखता है. यह एडिटर में कोई रेंज चुनने और Ctrl+Shift+[arrow key] दबाने के बराबर है. 

// Assume the active spreadsheet is blank.
const ss = SpreadsheetApp.getActiveSpreadsheet();
const sheet = ss.getSheets()[0];

// Makes C3 the current cell and C3:E5 the active range.
sheet.getRange('C3:E5').activate();
// Logs 'C1:E3'
console.log(
    SpreadsheetApp.getSelection()
        .getNextDataRange(SpreadsheetApp.Direction.UP)
        .getA1Notation(),
);

पैरामीटर

नामटाइपब्यौरा
directionDirectionअगले डेटा क्षेत्र की आखिरी सेल को खोजने की दिशा.

वापसी का टिकट

Range|null — यह डेटा सेल को शामिल करने वाली अडजस्ट की गई रेंज है. अगर कोई सेल नहीं चुनी गई है, तो null दिखेगा.

अनुमति देना

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

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