Class Selection

चुनना

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

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

var 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
var ranges =  selection.getActiveRangeList().getRanges();
for (var 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 दिखाता है. अगर आपने एक से ज़्यादा रेंज को चुनने पर, यह तरीका सिर्फ़ चुनी गई आखिरी रेंज दिखाता है.

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

वापसी का टिकट

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

अनुमति देना

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

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

getActiveRangeList()

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

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

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

वापसी का टिकट

RangeList — चालू रेंज की सूची.

अनुमति देना

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

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

getActiveSheet()

स्प्रेडशीट में ऐक्टिव शीट दिखाता है.

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

वापसी का टिकट

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

अनुमति देना

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

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

getCurrentCell()

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

var selection = SpreadsheetApp.getActiveSpreadsheet().getSelection();
// Returns the current highlighted cell in the one of the active ranges.
var 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 लौटाया जाता है. यह, रेंज में कोई रेंज चुनने के बराबर है एडिटर और Ctrl+Shift+[arrow key] हिट कर रहे हैं.

// Assume the active spreadsheet is blank.
var ss = SpreadsheetApp.getActiveSpreadsheet();
var 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