এই পৃষ্ঠাটি Cloud Translation API অনুবাদ করেছে।

Class Position

ডকুমেন্ট ট্যাবের কোনো একটি অবস্থানের রেফারেন্স, যা একটি নির্দিষ্ট এলিমেন্টের সাপেক্ষে নির্ধারিত হয়। অন্যান্য ব্যবহারের পাশাপাশি, ব্যবহারকারীর কার্সারকে একটি 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` নির্দিষ্ট পাঠ্য সন্নিবেশ করে।

বিস্তারিত ডকুমেন্টেশন

`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 এলিমেন্ট তৈরি করে যা Position ধারণকারী Paragraph বা ListItem এর টেক্সট এবং ফরম্যাটিংকে সরাসরি অথবা একাধিক চাইল্ড এলিমেন্টের মাধ্যমে উপস্থাপন করে। ফেরত আসা Text এলিমেন্টে Position এর অফসেট নির্ধারণ করতে getSurroundingTextOffset() ব্যবহার করুন।

ফেরত

Text — এমন একটি এলিমেন্ট যা Position ধারণকারী Paragraph বা ListItem উপর সরাসরি অথবা একাধিক চাইল্ড এলিমেন্টের শৃঙ্খলের মাধ্যমে editAsText() কল করার ফলাফলের সমতুল্য।

অনুমোদন

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`	`Blob Source`	এই `Position` সন্নিবেশ করার জন্য ছবির ডেটা

ফেরত

InlineImage |null — নতুন ইমেজ এলিমেন্ট, অথবা 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 — নতুন টেক্সট এলিমেন্ট, অথবা null যদি এই Position টি যে এলিমেন্টে অবস্থিত, সেখানে টেক্সট প্রবেশ করানো সম্ভব না হয়।

অনুমোদন

https://www.googleapis.com/auth/documents.currentonly
https://www.googleapis.com/auth/documents