একটি নির্দিষ্ট উপাদানের সাথে সম্পর্কিত নথি ট্যাবে একটি অবস্থানের একটি রেফারেন্স। ব্যবহারকারীর কার্সার অন্যান্য ব্যবহারের মধ্যে একটি 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 উপাদান তৈরি করে যা Paragraph বা List Item পাঠ্য এবং বিন্যাসকে প্রতিনিধিত্ব করে যেটিতে Position রয়েছে, সরাসরি বা চাইল্ড উপাদানগুলির একটি শৃঙ্খলের মাধ্যমে। |
get Surrounding Text Offset() | Integer | Text এলিমেন্টের মধ্যে এই Position অফসেট গেট get Surrounding Text() দ্বারা ফেরত দেয়। |
insert Bookmark() | Bookmark | এই Position একটি নতুন Bookmark তৈরি করে এবং সন্নিবেশ করায়। |
insert Inline Image(image) | Inline Image | নির্দিষ্ট ইমেজ ব্লব থেকে এই Position একটি নতুন Inline Image তৈরি করে এবং সন্নিবেশ করায়। |
insert Text(text) | Text | এই Position নির্দিষ্ট পাঠ্য সন্নিবেশ করান। |
বিস্তারিত ডকুমেন্টেশন
get Element()
এই Position ধারণ করে এমন উপাদান পায়। এটি হয় একটি Text উপাদান বা Paragraph মতো একটি ধারক উপাদান হবে। উভয় ক্ষেত্রেই, উপাদানের মধ্যে আপেক্ষিক অবস্থান get Offset() দিয়ে নির্ধারণ করা যেতে পারে।
প্রত্যাবর্তন
Element — ধারক বা Text উপাদান যেখানে এই Position বস্তুটি অবস্থিত
get Offset()
যে উপাদানটিতে এটি রয়েছে তার মধ্যে এই Position আপেক্ষিক অবস্থান পায়। যদি উপাদানটি একটি Text উপাদান হয়, অফসেটটি Position আগে অক্ষরের সংখ্যা (অর্থাৎ, এই Position পরে অক্ষরের সূচী); অন্য কোনো উপাদানের জন্য, অফসেট হল একই ধারক উপাদানের মধ্যে এই Position আগে শিশু উপাদানের সংখ্যা (অর্থাৎ, Position পরে চাইল্ড উপাদানের সূচক)।
প্রত্যাবর্তন
Integer — Text উপাদানগুলির জন্য, এই Position আগে অক্ষরের সংখ্যা; অন্যান্য উপাদানের জন্য, একই ধারক উপাদানের মধ্যে এই Position আগে চাইল্ড উপাদানের সংখ্যা
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Surrounding Text()
একটি কৃত্রিম Text উপাদান তৈরি করে যা Paragraph বা List Item পাঠ্য এবং বিন্যাসকে প্রতিনিধিত্ব করে যেটিতে Position রয়েছে, সরাসরি বা চাইল্ড উপাদানগুলির একটি শৃঙ্খলের মাধ্যমে। রিটার্ন করা Text এলিমেন্টে Position অফসেট নির্ধারণ করতে, get Surrounding Text Offset() ব্যবহার করুন।
প্রত্যাবর্তন
Text — Paragraph বা List Item edit As Text() কল করার ফলাফলের সমতুল্য একটি উপাদান যাতে Position থাকে, সরাসরি বা চাইল্ড উপাদানগুলির একটি শৃঙ্খলের মাধ্যমে।
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
get Surrounding Text Offset()
Text এলিমেন্টের মধ্যে এই Position অফসেট গেট get Surrounding Text() দ্বারা ফেরত দেয়। অফসেট হল Position আগে অক্ষরের সংখ্যা (অর্থাৎ, এই Position পরে অক্ষরের সূচী)।
প্রত্যাবর্তন
Integer — Paragraph বা List Item এই Position আগে অক্ষরের সংখ্যা যাতে Position থাকে, সরাসরি বা চাইল্ড উপাদানগুলির একটি চেইন দ্বারা
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Bookmark()
এই Position একটি নতুন Bookmark তৈরি করে এবং সন্নিবেশ করায়।
প্রত্যাবর্তন
Bookmark — নতুন বুকমার্ক
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents
insert Inline Image(image)
নির্দিষ্ট ইমেজ ব্লব থেকে এই Position একটি নতুন Inline Image তৈরি করে এবং সন্নিবেশ করায়।
পরামিতি
| নাম | টাইপ | বর্ণনা |
|---|---|---|
image | Blob Source | এই Position ঢোকাতে চিত্র ডেটা |
প্রত্যাবর্তন
Inline Image — নতুন ইমেজ এলিমেন্ট, বা null যদি এলিমেন্ট যেটিতে এই Position থাকে সেটি ইমেজ ঢোকানোর অনুমতি না দেয়
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
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 অবস্থিত তা পাঠ্য ঢোকানোর অনুমতি না দেয়
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly -
https://www.googleapis.com/auth/documents