Class Selection

নির্বাচন

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

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

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
get Active Range() Range সক্রিয় শীটে নির্বাচিত ব্যাপ্তি ফেরত দেয়, অথবা কোনো সক্রিয় ব্যাপ্তি না থাকলে null
get Active Range List() Range List সক্রিয় শীটে সক্রিয় ব্যাপ্তির তালিকা প্রদান করে বা যদি কোনো সক্রিয় ব্যাপ্তি না থাকে তাহলে null
get Active Sheet() Sheet স্প্রেডশীটে সক্রিয় শীট ফেরত দেয়।
get Current Cell() Range বর্তমান (হাইলাইট করা) কক্ষটি ফেরত দেয় যা সক্রিয় ব্যাপ্তির একটিতে নির্বাচিত হয় বা যদি বর্তমান ঘর না থাকে তাহলে null
get Next Data Range(direction) Range current cell এবং active range থেকে শুরু করে এবং প্রদত্ত দিকের দিকে অগ্রসর হওয়া, একটি সামঞ্জস্যপূর্ণ পরিসর প্রদান করে যেখানে বর্তমান সেলটিকে কভার করার সময় next data cell কভার করার জন্য পরিসরের উপযুক্ত প্রান্তটি স্থানান্তরিত করা হয়েছে৷

বিস্তারিত ডকুমেন্টেশন

get Active Range()

সক্রিয় শীটে নির্বাচিত ব্যাপ্তি ফেরত দেয়, অথবা কোনো সক্রিয় ব্যাপ্তি না থাকলে null । যদি একাধিক ব্যাপ্তি নির্বাচন করা হয় তবে এই পদ্ধতিটি শুধুমাত্র শেষ নির্বাচিত ব্যাপ্তি প্রদান করে।

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

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

Range — সক্রিয় পরিসর।

অনুমোদন

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

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

get Active Range List()

সক্রিয় শীটে সক্রিয় ব্যাপ্তির তালিকা প্রদান করে বা যদি কোনো সক্রিয় ব্যাপ্তি না থাকে তাহলে null

যদি একটি একক ব্যাপ্তি নির্বাচন করা থাকে, তাহলে এটি একটি get Active Range() কল হিসাবে আচরণ করে।

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

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

Range List — সক্রিয় ব্যাপ্তির তালিকা।

অনুমোদন

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

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

get Active Sheet()

স্প্রেডশীটে সক্রিয় শীট ফেরত দেয়।

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

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

Sheet — স্প্রেডশীটে সক্রিয় শীট।

অনুমোদন

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

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

get Current Cell()

বর্তমান (হাইলাইট করা) কক্ষটি ফেরত দেয় যা সক্রিয় ব্যাপ্তির একটিতে নির্বাচিত হয় বা যদি বর্তমান ঘর না থাকে তাহলে 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

get Next Data Range(direction)

current cell এবং active range থেকে শুরু করে এবং প্রদত্ত দিকের দিকে অগ্রসর হওয়া, একটি সামঞ্জস্যপূর্ণ পরিসর প্রদান করে যেখানে বর্তমান সেলটিকে কভার করার সময় next data cell কভার করার জন্য পরিসরের উপযুক্ত প্রান্তটি স্থানান্তরিত করা হয়েছে৷ যদি সক্রিয় পরিসরটি দিকনির্দেশের dimension বরাবর সীমাহীন থাকে, তবে আসল সক্রিয় পরিসরটি ফিরিয়ে দেওয়া হয়। কোন বর্তমান সেল বা সক্রিয় পরিসীমা না থাকলে, null ফেরত দেওয়া হয়। এটি সম্পাদকে একটি পরিসর নির্বাচন করা এবং 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(),
);

পরামিতি

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

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

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

অনুমোদন

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

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