এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

Class Selection

সক্রিয় শীটে বর্তমান সক্রিয় সিলেকশনটি অ্যাক্সেস করুন। সিলেকশন হলো শীটে ব্যবহারকারীর হাইলাইট করা সেলগুলোর একটি সেট, যা অসংলগ্ন রেঞ্জও হতে পারে। সিলেকশনের মধ্যে থাকা একটি সেল হলো বর্তমান সেল , যেখানে ব্যবহারকারীর বর্তমান ফোকাস রয়েছে। গুগল শীটস 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` অন্তর্ভুক্ত করার জন্য স্থানান্তরিত হয়।

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

`getActiveRange()`

সক্রিয় শীটে নির্বাচিত রেঞ্জটি ফেরত দেয়, অথবা কোনো সক্রিয় রেঞ্জ না থাকলে 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

`getActiveRangeList()`

সক্রিয় শীটে থাকা সক্রিয় রেঞ্জগুলোর তালিকা ফেরত দেয়, অথবা কোনো সক্রিয় রেঞ্জ না থাকলে null ফেরত দেয়।

যদি একটিমাত্র রেঞ্জ নির্বাচিত থাকে, তবে এটি getActiveRange() কল হিসেবে কাজ করে।

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

ফেরত

RangeList |null — সক্রিয় রেঞ্জগুলোর তালিকা।

অনুমোদন

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

`getActiveSheet()`

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

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

ফেরত

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

অনুমোদন

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

`getCurrentCell()`

সক্রিয় রেঞ্জগুলোর মধ্যে থেকে নির্বাচিত বর্তমান (হাইলাইট করা) সেলটি ফেরত দেয়, অথবা কোনো বর্তমান সেল না থাকলে 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

`getNextDataRange(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