ডকুমেন্ট ট্যাবে একটি নির্দিষ্ট উপাদানের সাথে সম্পর্কিত অবস্থানের একটি রেফারেন্স। ব্যবহারকারীর কার্সারটি অন্যান্য ব্যবহারের মধ্যে একটি Position হিসাবে উপস্থাপিত হয়। স্ক্রিপ্টগুলি কেবলমাত্র সেই ব্যবহারকারীর কার্সার অ্যাক্সেস করতে পারে যিনি স্ক্রিপ্টটি চালাচ্ছেন, এবং শুধুমাত্র যদি স্ক্রিপ্টটি ডকুমেন্টের সাথে আবদ্ধ থাকে।
// Insert some text at the cursor position and make it bold. const cursor = DocumentApp.getActiveDocument().getCursor(); if (cursor) { // Attempt to insert text at the cursor position. If the insertion returns // null, the cursor's containing element doesn't allow insertions, so show the // user an error message. const element = cursor.insertText('ಠ‿ಠ'); if (element) { element.setBold(true); } else { DocumentApp.getUi().alert('Cannot insert text here.'); } } else { DocumentApp.getUi().alert('Cannot find a cursor.'); }
পদ্ধতি
| পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বিবরণ |
|---|---|---|
get Element() | Element | এই Position ধারণকারী উপাদানটি পায়। |
get Offset() | Integer | এই Position ধারণকারী উপাদানের মধ্যে এর আপেক্ষিক অবস্থান পায়। |
get Surrounding Text() | Text | একটি কৃত্রিম Text উপাদান তৈরি করে যা Position ধারণকারী Paragraph বা List Item টেক্সট এবং বিন্যাস উপস্থাপন করে, হয় সরাসরি অথবা চাইল্ড উপাদানের একটি শৃঙ্খলের মাধ্যমে। |
get Surrounding Text Offset() | Integer | get Surrounding Text() দ্বারা ফিরে আসা Text উপাদানের মধ্যে এই Position অফসেট পায়। |
insert Bookmark() | Bookmark | এই Position একটি নতুন Bookmark তৈরি করে এবং সন্নিবেশ করায়। |
insert Inline Image(image) | Inline Image |null | নির্দিষ্ট ইমেজ ব্লব থেকে এই Position একটি নতুন Inline Image তৈরি করে এবং সন্নিবেশ করায়। |
insert Text(text) | Text |null | এই Position নির্দিষ্ট টেক্সট সন্নিবেশ করান। |
বিস্তারিত ডকুমেন্টেশন
get Element()
এই Position ধারণকারী উপাদানটি পায়। এটি হয় একটি Text উপাদান হবে অথবা Paragraph মতো একটি ধারক উপাদান হবে। উভয় ক্ষেত্রেই, উপাদানের মধ্যে আপেক্ষিক অবস্থান get Offset() দিয়ে নির্ধারণ করা যেতে পারে।
প্রত্যাবর্তন
Element — যে কন্টেইনার বা Text এলিমেন্টে এই Position অবজেক্টটি অবস্থিত
get Offset()
এই Position এর আপেক্ষিক অবস্থানটি যে উপাদানটিতে এটি রয়েছে তার মধ্যে পায়। যদি উপাদানটি একটি Text উপাদান হয়, তাহলে অফসেট হল Position এর আগে থাকা অক্ষরের সংখ্যা (অর্থাৎ, this Position পরে থাকা অক্ষরের সূচক); অন্য যেকোনো উপাদানের জন্য, অফসেট হল একই ধারক উপাদানের মধ্যে থাকা Position এর আগে থাকা চাইল্ড উপাদানের সংখ্যা (অর্থাৎ, Position এর পরে থাকা চাইল্ড উপাদানের সূচক)।
প্রত্যাবর্তন
Integer — Text এলিমেন্টের জন্য, এই Position এর আগে থাকা অক্ষরের সংখ্যা; অন্যান্য এলিমেন্টের জন্য, একই কন্টেইনার এলিমেন্টের মধ্যে এই Position এর আগে থাকা চাইল্ড এলিমেন্টের সংখ্যা
অনুমোদন
এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Surrounding Text()
একটি কৃত্রিম Text এলিমেন্ট তৈরি করে যা Position ধারণকারী Paragraph বা List Item এর টেক্সট এবং ফর্ম্যাটিং প্রতিনিধিত্ব করে, সরাসরি অথবা চাইল্ড এলিমেন্টের একটি শৃঙ্খলের মাধ্যমে। ফিরে আসা Text এলিমেন্টে Position এর অফসেট নির্ধারণ করতে, get Surrounding Text Offset() ব্যবহার করুন।
প্রত্যাবর্তন
Text — Position ধারণকারী Paragraph অথবা List Item এ edit As Text() কল করার ফলাফলের সমতুল্য একটি উপাদান, হয় সরাসরি অথবা চাইল্ড এলিমেন্টের একটি শৃঙ্খলের মাধ্যমে।
অনুমোদন
এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Surrounding Text Offset()
get Surrounding Text() দ্বারা ফিরে আসা Text উপাদানের মধ্যে এই Position অফসেট পায়। অফসেট হল Position আগে অক্ষরের সংখ্যা (অর্থাৎ, এই Position পরে অক্ষরের সূচক)।
প্রত্যাবর্তন
Integer — Paragraph বা List Item এই Position আগে অক্ষরের সংখ্যা যেখানে Position সরাসরি বা শিশু উপাদানের একটি শৃঙ্খলের মাধ্যমে থাকে।
অনুমোদন
এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Bookmark()
insert Inline Image(image)
নির্দিষ্ট ইমেজ ব্লব থেকে এই Position একটি নতুন Inline Image তৈরি করে এবং সন্নিবেশ করায়।
পরামিতি
| নাম | আদর্শ | বিবরণ |
|---|---|---|
image | Blob Source | এই Position সন্নিবেশ করানোর জন্য চিত্রের তথ্য |
প্রত্যাবর্তন
Inline Image |null — নতুন ইমেজ এলিমেন্ট, অথবা যদি এই Position যে এলিমেন্টে অবস্থিত সেটি ইমেজ সন্নিবেশ করার অনুমতি না দেয় তাহলে null
অনুমোদন
এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Text(text)
এই Position নির্দিষ্ট টেক্সট সন্নিবেশ করান। এই পদ্ধতিটি একটি নতুন Text উপাদান তৈরি করে, এমনকি যদি স্ট্রিংটি একটি বিদ্যমান Text উপাদানের মধ্যে সন্নিবেশ করা হয়, যাতে নতুন উপাদানটি স্টাইল করা সহজ হয়।
পরামিতি
| নাম | আদর্শ | বিবরণ |
|---|---|---|
text | String | এই Position যে স্ট্রিংটি সন্নিবেশ করাতে হবে |
প্রত্যাবর্তন
Text |null — নতুন টেক্সট এলিমেন্ট, অথবা যদি এই Position যে এলিমেন্টে অবস্থিত সেটি টেক্সট সন্নিবেশ করার অনুমতি না দেয় তাহলে null
অনুমোদন
এই পদ্ধতি ব্যবহার করে এমন স্ক্রিপ্টগুলির জন্য নিম্নলিখিত এক বা একাধিক স্কোপের অনুমোদন প্রয়োজন:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents