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

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

get Active Range()

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

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

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

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

অনুমোদন

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

  • 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 |null — সক্রিয় পরিসরের তালিকা।

অনুমোদন

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

  • 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 |null — বর্তমান ঘর।

অনুমোদন

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

  • 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 — ডেটা সেল অন্তর্ভুক্ত করে এমন সামঞ্জস্যপূর্ণ পরিসর, অথবা যদি কোনও নির্বাচন না থাকে তবে null

অনুমোদন

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

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