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)	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