একটি নির্দিষ্ট উপাদানের সাথে সম্পর্কিত নথি ট্যাবে একটি অবস্থানের একটি রেফারেন্স। ব্যবহারকারীর কার্সার অন্যান্য ব্যবহারের মধ্যে একটি 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