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 दिखाता है.
getActiveRangeList()RangeListअगर कोई ऐक्टिव रेंज नहीं है, तो चालू शीट या null में ऐक्टिव रेंज की सूची दिखाता है.
getActiveSheet()Sheetस्प्रेडशीट में मौजूद ऐक्टिव शीट दिखाता है.
getCurrentCell()Rangeयह फ़ंक्शन, किसी ऐक्टिव रेंज में से चुनी गई मौजूदा (हाइलाइट की गई) सेल दिखाता है. अगर कोई मौजूदा सेल नहीं है, तो यह null दिखाता है.
getNextDataRange(direction)Rangecurrent cell और active range से शुरू करके, दिए गए निर्देश में जाकर, बदली गई रेंज दिखाता है. इसमें रेंज के सही किनारे को next data cell को कवर करने के लिए, मौजूदा सेल को कवर करते हुए शिफ़्ट किया गया है.

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

getActiveRange()

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

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

वापसी का टिकट

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

अनुमति देना

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

  • 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 — ऐक्टिव रेंज की सूची.

अनुमति देना

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

  • 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 दिखाता है. 

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

वापसी का टिकट

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

अनुमति देना

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

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

getNextDataRange(direction)

current cell और active range से शुरू करके, दिए गए निर्देश में जाकर, बदली गई रेंज दिखाता है. इसमें रेंज के सही किनारे को next data cell को कवर करने के लिए, मौजूदा सेल को कवर करते हुए शिफ़्ट किया गया है. अगर डायरेक्शन के dimension के साथ चालू रेंज अनबाउंड है, तो ओरिजनल चालू रेंज दिखाया जाता है. अगर कोई मौजूदा सेल या ऐक्टिव रेंज नहीं है, तो null दिखाया जाता है. यह Editor में कोई रेंज चुनने और 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.

अनुमति देना

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

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