একটি ডকুমেন্টের উপাদানসমূহের একটি পরিসর। ব্যবহারকারীর নির্বাচনকে অন্যান্য ব্যবহারের পাশাপাশি একটি Range (Range) হিসেবে উপস্থাপন করা হয়। স্ক্রিপ্ট শুধুমাত্র সেই ব্যবহারকারীর নির্বাচন অ্যাক্সেস করতে পারে যিনি স্ক্রিপ্টটি চালাচ্ছেন, এবং তাও কেবল যদি স্ক্রিপ্টটি ডকুমেন্টের সাথে আবদ্ধ থাকে।
// Bold all selected text. const selection = DocumentApp.getActiveDocument().getSelection(); if (selection) { const elements = selection.getRangeElements(); for (let i = 0; i < elements.length; i++) { const element = elements[i]; // Only modify elements that can be edited as text; skip images and other // non-text elements. if (element.getElement().editAsText) { const text = element.getElement().editAsText(); // Bold the selected part of the element, or the full element if it's // completely selected. if (element.isPartial()) { text.setBold( element.getStartOffset(), element.getEndOffsetInclusive(), true, ); } else { text.setBold(true); } } } }
পদ্ধতি
| পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বিবরণ |
|---|---|---|
get Range Elements() | Range Element[] | এই Range অন্তর্গত সমস্ত উপাদান পায়, যার মধ্যে যেকোনো আংশিক Text উপাদানও অন্তর্ভুক্ত থাকে (উদাহরণস্বরূপ, এমন একটি নির্বাচনের ক্ষেত্রে যেখানে কেবল একটি Text উপাদানের অংশবিশেষ রয়েছে)। |
বিস্তারিত ডকুমেন্টেশন
getRangeElements()
এই Range সমস্ত এলিমেন্ট পায়, যার মধ্যে যেকোনো আংশিক Text এলিমেন্টও অন্তর্ভুক্ত থাকে (উদাহরণস্বরূপ, এমন একটি নির্বাচনের ক্ষেত্রে যেখানে একটি Text এলিমেন্টের কেবল অংশবিশেষ অন্তর্ভুক্ত থাকে)। কোনো Text এলিমেন্ট রেঞ্জের মধ্যে আংশিকভাবে অন্তর্ভুক্ত কিনা তা নির্ধারণ করতে, RangeElement.isPartial() দেখুন।
ফেরত
RangeElement[] — এলিমেন্টগুলোর একটি অ্যারে, যা ডকুমেন্টে তাদের উপস্থিতির ক্রমানুসারে সাজানো থাকে।
অনুমোদন
যে স্ক্রিপ্টগুলো এই পদ্ধতি ব্যবহার করে, সেগুলোর জন্য নিম্নলিখিত এক বা একাধিক স্কোপের মাধ্যমে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents