Class NamedRange

নামকৃত রেঞ্জ

পরে পুনরুদ্ধারের অনুমতি দেওয়ার জন্য একটি নাম এবং আইডি আছে এমন একটি Range । নামগুলি অগত্যা অনন্য নয়; একই ট্যাবে বিভিন্ন রেঞ্জ একই নাম শেয়ার করতে পারে, অনেকটা HTML-এর ক্লাসের মতো। বিপরীতে, আইডিগুলি ট্যাবের মধ্যে অনন্য, যেমন HTML-এর একটি ID। একবার একটি ট্যাবে একটি NamedRange যোগ করা হলে, এটি সংশোধন করা যাবে না, শুধুমাত্র সরানো যাবে।

একটি NamedRange ট্যাব অ্যাক্সেস করে এমন যেকোনো স্ক্রিপ্ট দ্বারা অ্যাক্সেস করা যেতে পারে। স্ক্রিপ্টগুলির মধ্যে অনিচ্ছাকৃত দ্বন্দ্ব এড়াতে, একটি অনন্য স্ট্রিং সহ রেঞ্জের নামগুলি উপসর্গ করার কথা বিবেচনা করুন।

// Create a named range that includes every table in the active tab.
var documentTab = DocumentApp.getActiveDocument().getActiveTab().asDocumentTab();
var rangeBuilder = documentTab.newRange();
var tables = documentTab.getBody().getTables();
for (var i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('myUniquePrefix-tables', rangeBuilder.build());

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
getId() String এই NamedRange এর আইডি পায়।
getName() String এই NamedRange এর নাম পায়।
getRange() Range এই NamedRange এর সাথে যুক্ত উপাদানের পরিসীমা পায়।
remove() void ট্যাব থেকে এই NamedRange সরিয়ে দেয়।

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

getId()

এই NamedRange এর আইডি পায়। আইডি ট্যাবের মধ্যে অনন্য।

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

String - রেঞ্জের আইডি, যা ট্যাবের মধ্যে অনন্য।

getName()

এই NamedRange এর নাম পায়। নামটি অগত্যা অনন্য নয়।

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

String — পরিসরের নাম, যা অগত্যা অনন্য নয়।

অনুমোদন

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

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

getRange()

এই NamedRange এর সাথে যুক্ত উপাদানের পরিসীমা পায়।

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

Range — নাম এবং আইডির সাথে যুক্ত উপাদানের পরিসর।

অনুমোদন

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

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

remove()

ট্যাব থেকে এই NamedRange সরিয়ে দেয়। এই পদ্ধতি পরিসরের বিষয়বস্তু মুছে দেয় না; এটা শুধুমাত্র রেফারেন্স মুছে দেয়. ইতিমধ্যেই সরানো হয়েছে এমন একটি NamedRange এ এই পদ্ধতিটিকে কল করার কোনো প্রভাব নেই৷

অনুমোদন

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

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