Class Position

অবস্থান

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

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

IntegerText উপাদানগুলির জন্য, এই Position আগে অক্ষরের সংখ্যা; অন্যান্য উপাদানের জন্য, একই ধারক উপাদানের মধ্যে এই Position আগে চাইল্ড উপাদানের সংখ্যা

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

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

getSurroundingText()

একটি কৃত্রিম Text উপাদান তৈরি করে যা Paragraph বা ListItem পাঠ্য এবং বিন্যাসকে প্রতিনিধিত্ব করে যেটিতে Position রয়েছে, সরাসরি বা চাইল্ড উপাদানগুলির একটি চেইনের মাধ্যমে৷ ফিরে আসা Text উপাদানে Position অফসেট নির্ধারণ করতে, getSurroundingTextOffset() ব্যবহার করুন।

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

TextParagraph বা ListItem editAsText() কল করার ফলাফলের সমতুল্য একটি উপাদান যাতে Position থাকে, সরাসরি বা চাইল্ড এলিমেন্টের একটি চেইনের মাধ্যমে

অনুমোদন

যে স্ক্রিপ্টগুলি এই পদ্ধতিটি ব্যবহার করে তাদের নিম্নলিখিত এক বা একাধিক সুযোগের সাথে অনুমোদনের প্রয়োজন হয়:

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

getSurroundingTextOffset()

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

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

IntegerParagraph বা 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