Class Selection

নির্বাচন

সক্রিয় শীটে বর্তমান সক্রিয় নির্বাচন অ্যাক্সেস করুন। একটি নির্বাচন হল সেই কক্ষগুলির সেট যা ব্যবহারকারী শীটে হাইলাইট করেছেন, যা অ-সংলগ্ন ব্যাপ্তি হতে পারে। নির্বাচনের একটি কক্ষ হল বর্তমান সেল , যেখানে ব্যবহারকারীর বর্তমান ফোকাস। বর্তমান সেলটি Google Sheets UI-তে একটি গাঢ় সীমানা দিয়ে হাইলাইট করা হয়েছে।

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

পরামিতি

নাম টাইপ বর্ণনা
direction Direction যে দিক থেকে পরবর্তী ডেটা অঞ্চল প্রান্তের ঘরটি খুঁজে বের করতে হবে।

প্রত্যাবর্তন

Range — সামঞ্জস্য করা পরিসর যা ডেটা সেল অন্তর্ভুক্ত করে, অথবা যদি কোনো নির্বাচন না থাকে তাহলে null

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

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