ऐक्टिव शीट में, चुने गए मौजूदा विकल्प को ऐक्सेस करें. चुना गया सेल का वह सेट होता है जिसे उपयोगकर्ता ने शीट में हाइलाइट किया है. ये रेंज, आपस में मेल नहीं खातीं. चुने गए में एक सेल मौजूदा सेल है, जहां उपयोगकर्ता का मौजूदा फ़ोकस है. मौजूदा सेल को 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) | Range | current 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());
पैरामीटर
नाम | Type | ब्यौरा |
---|---|---|
direction | Direction | वह दिशा जिसमें अगले डेटा क्षेत्र के किनारे वाले सेल को खोजना है. |
रिटर्न
Range
— वह अडजस्ट रेंज जिसमें डेटा सेल शामिल है. इसके अलावा, अगर आपने कोई वैल्यू नहीं चुनी है,
तो null
.
अनुमति देना
इस तरीके का इस्तेमाल करने वाली स्क्रिप्ट को, इनमें से एक या ज़्यादा स्कोप से अनुमति देने की ज़रूरत होती है:
-
https://www.googleapis.com/auth/spreadsheets.currentonly
-
https://www.googleapis.com/auth/spreadsheets