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 নির্দিষ্ট টেক্সট সন্নিবেশ করান।

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

get Element()

এই Position ধারণকারী উপাদানটি পায়। এটি হয় একটি Text উপাদান হবে অথবা Paragraph মতো একটি ধারক উপাদান হবে। উভয় ক্ষেত্রেই, উপাদানের মধ্যে আপেক্ষিক অবস্থান get Offset() দিয়ে নির্ধারণ করা যেতে পারে।

প্রত্যাবর্তন

Element — যে কন্টেইনার বা Text এলিমেন্টে এই Position অবজেক্টটি অবস্থিত


get Offset()

এই Position এর আপেক্ষিক অবস্থানটি যে উপাদানটিতে এটি রয়েছে তার মধ্যে পায়। যদি উপাদানটি একটি Text উপাদান হয়, তাহলে অফসেট হল Position এর আগে থাকা অক্ষরের সংখ্যা (অর্থাৎ, this Position পরে থাকা অক্ষরের সূচক); অন্য যেকোনো উপাদানের জন্য, অফসেট হল একই ধারক উপাদানের মধ্যে থাকা Position এর আগে থাকা চাইল্ড উপাদানের সংখ্যা (অর্থাৎ, Position এর পরে থাকা চাইল্ড উপাদানের সূচক)।

প্রত্যাবর্তন

IntegerText এলিমেন্টের জন্য, এই 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() ব্যবহার করুন।

প্রত্যাবর্তন

TextPosition ধারণকারী Paragraph অথবা List Itemedit 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 পরে অক্ষরের সূচক)।

প্রত্যাবর্তন

IntegerParagraph বা 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 যে এলিমেন্টে অবস্থিত সেটি ইমেজ সন্নিবেশ করার অনুমতি না দেয় তাহলে 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