একটি নির্দিষ্ট উপাদানের সাথে সম্পর্কিত নথি ট্যাবে একটি অবস্থানের একটি রেফারেন্স। ব্যবহারকারীর কার্সার অন্যান্য ব্যবহারের মধ্যে একটি Position
হিসাবে উপস্থাপিত হয়। স্ক্রিপ্টগুলি শুধুমাত্র সেই ব্যবহারকারীর কার্সার অ্যাক্সেস করতে পারে যিনি স্ক্রিপ্টটি চালাচ্ছেন, এবং শুধুমাত্র যদি স্ক্রিপ্টটি নথিতে আবদ্ধ থাকে।
// Insert some text at the cursor position and make it bold. var 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. var element = cursor.insertText('ಠ‿ಠ'); if (element) { element.setBold(true); } else { DocumentApp.getUi().alert('Cannot insert text here.'); } } else { DocumentApp.getUi().alert('Cannot find a cursor.'); }
পদ্ধতি
পদ্ধতি | রিটার্ন টাইপ | সংক্ষিপ্ত বিবরণ |
---|---|---|
getElement() | Element | এই Position ধারণ করে এমন উপাদান পায়। |
getOffset() | Integer | যে উপাদানটিতে এটি রয়েছে তার মধ্যে এই Position আপেক্ষিক অবস্থান পায়। |
getSurroundingText() | Text | একটি কৃত্রিম Text উপাদান তৈরি করে যা Paragraph বা ListItem পাঠ্য এবং বিন্যাসকে প্রতিনিধিত্ব করে যেটিতে Position রয়েছে, সরাসরি বা চাইল্ড উপাদানগুলির একটি চেইনের মাধ্যমে৷ |
getSurroundingTextOffset() | Integer | getSurroundingText() দ্বারা প্রত্যাবর্তিত Text উপাদানের মধ্যে এই Position অফসেট পায়। |
insertBookmark() | Bookmark | এই Position একটি নতুন Bookmark তৈরি করে এবং সন্নিবেশ করায়। |
insertInlineImage(image) | InlineImage | নির্দিষ্ট ইমেজ ব্লব থেকে এই Position একটি নতুন InlineImage তৈরি করে এবং সন্নিবেশ করায়। |
insertText(text) | Text | এই Position নির্দিষ্ট পাঠ্য সন্নিবেশ করান। |
বিস্তারিত ডকুমেন্টেশন
getElement()
এই Position
ধারণ করে এমন উপাদান পায়। এটি হয় একটি Text
উপাদান বা Paragraph
মতো একটি ধারক উপাদান হবে। উভয় ক্ষেত্রেই, উপাদানের মধ্যে আপেক্ষিক অবস্থান getOffset()
দিয়ে নির্ধারণ করা যেতে পারে।
প্রত্যাবর্তন
Element
— ধারক বা Text
উপাদান যেখানে এই Position
বস্তুটি অবস্থিত
getOffset()
যে উপাদানটিতে এটি রয়েছে তার মধ্যে এই Position
আপেক্ষিক অবস্থান পায়। যদি উপাদানটি একটি Text
উপাদান হয়, অফসেটটি Position
আগে অক্ষরের সংখ্যা (অর্থাৎ, এই Position
পরে অক্ষরের সূচী); অন্য কোনো উপাদানের জন্য, অফসেট হল একই ধারক উপাদানের মধ্যে এই Position
আগে শিশু উপাদানের সংখ্যা (অর্থাৎ, Position
পরে চাইল্ড উপাদানের সূচক)।
প্রত্যাবর্তন
Integer
— Text
উপাদানগুলির জন্য, এই Position
আগে অক্ষরের সংখ্যা; অন্যান্য উপাদানের জন্য, একই ধারক উপাদানের মধ্যে এই Position
আগে চাইল্ড উপাদানের সংখ্যা
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getSurroundingText()
একটি কৃত্রিম Text
উপাদান তৈরি করে যা Paragraph
বা ListItem
পাঠ্য এবং বিন্যাসকে প্রতিনিধিত্ব করে যেটিতে Position
রয়েছে, সরাসরি বা চাইল্ড উপাদানগুলির একটি চেইনের মাধ্যমে৷ ফিরে আসা Text
উপাদানে Position
অফসেট নির্ধারণ করতে, getSurroundingTextOffset()
ব্যবহার করুন।
প্রত্যাবর্তন
Text
— Paragraph
বা ListItem
editAsText()
কল করার ফলাফলের সমতুল্য একটি উপাদান যাতে Position
থাকে, সরাসরি বা চাইল্ড এলিমেন্টের একটি চেইনের মাধ্যমে
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
getSurroundingTextOffset()
getSurroundingText()
দ্বারা প্রত্যাবর্তিত Text
উপাদানের মধ্যে এই Position
অফসেট পায়। অফসেট হল Position
আগে অক্ষরের সংখ্যা (অর্থাৎ, এই Position
পরে অক্ষরের সূচী)।
প্রত্যাবর্তন
Integer
— Paragraph
বা ListItem
এই Position
আগে অক্ষরের সংখ্যা যাতে Position
থাকে, সরাসরি বা চাইল্ড উপাদানগুলির একটি চেইন দ্বারা
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertBookmark()
এই Position
একটি নতুন Bookmark
তৈরি করে এবং সন্নিবেশ করায়।
প্রত্যাবর্তন
Bookmark
— নতুন বুকমার্ক
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertInlineImage(image)
নির্দিষ্ট ইমেজ ব্লব থেকে এই Position
একটি নতুন InlineImage
তৈরি করে এবং সন্নিবেশ করায়।
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
image | BlobSource | এই Position ঢোকাতে চিত্র ডেটা |
প্রত্যাবর্তন
InlineImage
— নতুন ইমেজ এলিমেন্ট, অথবা null
যদি এলিমেন্ট যেটিতে এই Position
থাকে সেটি ইমেজ ঢোকানোর অনুমতি না দেয়
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents
insertText(text)
এই Position
নির্দিষ্ট পাঠ্য সন্নিবেশ করান। এই পদ্ধতিটি একটি নতুন Text
উপাদান তৈরি করে, এমনকি যদি একটি বিদ্যমান Text
উপাদানের মধ্যে স্ট্রিংটি ঢোকানো হয়, যাতে নতুন উপাদানটিকে স্টাইল করা সহজ হয়।
পরামিতি
নাম | টাইপ | বর্ণনা |
---|---|---|
text | String | এই Position সন্নিবেশ করার জন্য স্ট্রিং |
প্রত্যাবর্তন
Text
— নতুন পাঠ্য উপাদান, বা null
যদি উপাদানটি যেটিতে এই Position
অবস্থিত তা পাঠ্য ঢোকানোর অনুমতি না দেয়
অনুমোদন
যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:
-
https://www.googleapis.com/auth/documents.currentonly
-
https://www.googleapis.com/auth/documents