Class DocumentTab

ডকুমেন্টট্যাব

একটি ডকুমেন্ট ট্যাব, যেখানে রিচ টেক্সট এবং টেবিল ও তালিকার মতো উপাদান রয়েছে।

Document.getTabs()[tabIndex].asDocumentTab() ব্যবহার করে একটি ডকুমেন্ট ট্যাব পুনরুদ্ধার করুন।

// Get a specific document tab based on the tab ID.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();

পদ্ধতি

পদ্ধতি রিটার্ন টাইপ সংক্ষিপ্ত বিবরণ
add Bookmark(position) Bookmark প্রদত্ত Position একটি Bookmark যোগ করে।
add Footer() Footer Section যদি কোনো ট্যাব ফুটার সেকশন না থাকে, তবে একটি যোগ করে।
add Header() Header Section যদি কোনো ট্যাব হেডার সেকশন না থাকে, তবে একটি যোগ করে।
add Named Range(name, range) Named Range একটি Named Range যোগ করে, যা পরবর্তীতে পুনরুদ্ধারের জন্য ব্যবহারযোগ্য একটি নাম এবং আইডিযুক্ত Range ।
get Body() Body ট্যাবের Body পুনরুদ্ধার করে।
get Bookmark(id) Bookmark |null প্রদত্ত আইডি দিয়ে Bookmark পাওয়া যায়।
get Bookmarks() Bookmark[] ট্যাবে থাকা সমস্ত Bookmark অবজেক্ট নিয়ে আসে।
get Footer() Footer Section |null ট্যাবটির ফুটার সেকশন পুনরুদ্ধার করে, যদি তা বিদ্যমান থাকে।
get Footnotes() Footnote[] |null ট্যাবের মূল অংশে থাকা সমস্ত Footnote উপাদান পুনরুদ্ধার করে।
get Header() Header Section |null ট্যাবটির হেডার সেকশন পুনরুদ্ধার করে, যদি তা বিদ্যমান থাকে।
get Named Range By Id(id) Named Range |null প্রদত্ত আইডি দিয়ে Named Range পাওয়া যায়।
get Named Ranges() Named Range[] ট্যাবে থাকা সমস্ত Named Range অবজেক্ট নিয়ে আসে।
get Named Ranges(name) Named Range[] ট্যাবে থাকা প্রদত্ত নামের সমস্ত Named Range অবজেক্ট খুঁজে বের করে।
new Position(element, offset) Position একটি নতুন Position তৈরি করে, যা একটি নির্দিষ্ট এলিমেন্টের সাপেক্ষে ট্যাবের কোনো একটি অবস্থানের রেফারেন্স।
new Range() Range Builder ট্যাব এলিমেন্ট থেকে Range অবজেক্ট তৈরি করতে ব্যবহৃত একটি বিল্ডার তৈরি করে।

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

addBookmark(position)

প্রদত্ত Position একটি Bookmark যোগ করে।

// Opens the Docs file and retrieves the tab by its IDs. If you created your
// script from within a Google Docs file, you can use
// DocumentApp.getActiveDocument().getActiveTab() instead.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();

// Gets the tab body and adds a paragraph.
const paragraph = documentTab.getBody().appendParagraph('My new paragraph.');

// Creates a position at the first character of the paragraph text.
const position = documentTab.newPosition(paragraph.getChild(0), 0);

// Adds a bookmark at the first character of the paragraph text.
const bookmark = documentTab.addBookmark(position);

// Logs the bookmark ID to the console.
console.log(bookmark.getId());

প্যারামিটার

নাম প্রকার বর্ণনা
position Position নতুন বুকমার্কটির অবস্থান।

ফেরত

Bookmark — নতুন বুকমার্ক।

অনুমোদন

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

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

addFooter()

যদি কোনো ট্যাব ফুটার সেকশন না থাকে, তবে একটি যোগ করে।

// Opens the Docs file and retrieves the tab by its IDs. If you created your
// script from within a Google Docs file, you can use
// DocumentApp.getActiveDocument().getActiveTab() instead.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();

// Adds a footer to the tab.
const footer = documentTab.addFooter();

// Sets the footer text to 'This is a footer.'
footer.setText('This is a footer');

ফেরত

FooterSection — ট্যাব ফুটার।

অনুমোদন

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

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

addHeader()

যদি কোনো ট্যাব হেডার সেকশন না থাকে, তবে একটি যোগ করে।

// Opens the Docs file and retrieves the tab by its IDs. If you created your
// script from within a Google Docs file, you can use
// DocumentApp.getActiveDocument().getActiveTab() instead.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();

// Adds a header to the tab.
const header = documentTab.addHeader();

// Sets the header text to 'This is a header.'
header.setText('This is a header');

ফেরত

HeaderSection — ট্যাব হেডার।

অনুমোদন

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

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

addNamedRange(name, range)

একটি NamedRange যোগ করে, যা হলো এমন একটি Range যার একটি নাম এবং আইডি থাকে, যা পরবর্তীতে খুঁজে বের করার জন্য ব্যবহৃত হয়। নামগুলো সবসময় অনন্য হয় না, এমনকি বিভিন্ন ট্যাবের মধ্যেও; একই ডকুমেন্টের মধ্যে থাকা একাধিক রেঞ্জ একই নাম ব্যবহার করতে পারে, অনেকটা HTML-এর ক্লাসের মতো। এর বিপরীতে, আইডিগুলো ডকুমেন্টের মধ্যে অনন্য হয়, যেমনটা HTML-এর আইডি হয়ে থাকে। একবার NamedRange যোগ করার পর আপনি এটি পরিবর্তন করতে পারবেন না, শুধুমাত্র মুছে ফেলতে পারবেন।

যে কোনো স্ক্রিপ্ট যা ট্যাব অ্যাক্সেস করে, তা একটি NamedRange অ্যাক্সেস করতে পারে। স্ক্রিপ্টগুলোর মধ্যে অনাকাঙ্ক্ষিত দ্বন্দ্ব এড়াতে, রেঞ্জের নামের আগে একটি অনন্য স্ট্রিং যোগ করার কথা বিবেচনা করুন।

// Creates a named range that includes every table in a tab by its ID.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
documentTab.addNamedRange('Tab t.0 tables', rangeBuilder.build());

প্যারামিটার

নাম প্রকার বর্ণনা
name String রেঞ্জের নামটি অনন্য হওয়ার প্রয়োজন নেই; রেঞ্জের নাম অবশ্যই ১ থেকে ২৫৬ অক্ষরের মধ্যে হতে হবে।
range Range নামের সাথে যুক্ত করার জন্য উপাদানগুলির পরিসর; এই পরিসরটি একটি অনুসন্ধানের ফলাফল হতে পারে অথবা new Range() ব্যবহার করে ম্যানুয়ালি তৈরি করা যেতে পারে।

ফেরত

NamedRange — দ্য NamedRange ।

অনুমোদন

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

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

getBody()

ট্যাবের Body পুনরুদ্ধার করে।

ট্যাবে বিভিন্ন ধরনের সেকশন থাকতে পারে (যেমন, HeaderSection , FooterSection )। একটি ট্যাবের সক্রিয় সেকশন হলো তার Body ।

DocumentTab এর এলিমেন্ট মেথডগুলো Body তে দায়িত্ব অর্পণ করে।

// Opens the Docs file and retrieves the tab by its IDs. If you created your
// script from within a Google Docs file, you can use
// DocumentApp.getActiveDocument().getActiveTab() instead.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();

// Gets the tab body.
const body = documentTab.getBody();

// Gets the body text and logs it to the console.
console.log(body.getText());

ফেরত

Body — ট্যাবটির মূল অংশ।

অনুমোদন

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

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

getBookmark(id)

প্রদত্ত আইডি সহ Bookmark খুঁজে বের করে। এই ট্যাবের মধ্যে যদি সেরকম কোনো Bookmark না থাকে, তাহলে এই মেথডটি null রিটার্ন করে।

// Opens the Docs file and retrieves the tab by its IDs. If you created your
// script from within a Google Docs file, you can use
// DocumentApp.getActiveDocument().getActiveTab() instead.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();

// Gets the bookmark by its ID.
const bookmark = documentTab.getBookmark('id.xyz654321');

// If the bookmark exists within the tab, logs the character offset of its
// position to the console. Otherwise, logs 'No bookmark exists with the given
// ID.' to the console.
if (bookmark) {
  console.log(bookmark.getPosition().getOffset());
} else {
  console.log('No bookmark exists with the given ID.');
}

প্যারামিটার

নাম প্রকার বর্ণনা
id String Bookmark আইডি।

ফেরত

Bookmark |null — প্রদত্ত আইডি সহ Bookmark , অথবা ট্যাবের মধ্যে এই ধরনের কোনো Bookmark না থাকলে null ।

অনুমোদন

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

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

getBookmarks()

ট্যাবে থাকা সমস্ত Bookmark অবজেক্ট নিয়ে আসে।

// Opens the Docs file and retrieves the tab by its IDs. If you created your
// script from within a Google Docs file, you can use
// DocumentApp.getActiveDocument().getActiveTab() instead.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();

// Gets all of the bookmarks in the tab.
const bookmarks = documentTab.getBookmarks();

// Logs the number of bookmarks in the tab to the console.
console.log(bookmarks.length);

ফেরত

Bookmark[] — ট্যাবে থাকা Bookmark অবজেক্টগুলোর একটি অ্যারে।

অনুমোদন

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

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

getFooter()

ট্যাবটির ফুটার সেকশন পুনরুদ্ধার করে, যদি তা বিদ্যমান থাকে।

// Opens the Docs file and retrieves the tab by its IDs. If you created your
// script from within a Google Docs file, you can use
// DocumentApp.getActiveDocument().getActiveTab() instead.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();

// Gets the text of the tab's footer and logs it to the console.
console.log(documentTab.getFooter().getText());

ফেরত

FooterSection |null — ট্যাবটির ফুটার।

অনুমোদন

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

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

getFootnotes()

ট্যাবের মূল অংশে থাকা সমস্ত Footnote উপাদান পুনরুদ্ধার করে।

getFootnotes কল করলে ট্যাবের উপাদানগুলোর উপর পুনরাবৃত্তি ঘটে। বড় ট্যাবের ক্ষেত্রে, এই মেথডটির অপ্রয়োজনীয় কল এড়িয়ে চলুন। 

// Opens the Docs file and retrieves the tab by its IDs. If you created your
// script from within a Google Docs file, you can use
// DocumentApp.getActiveDocument().getActiveTab() instead.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();

// Gets the first footnote.
const footnote = documentTab.getFootnotes()[0];

// Logs footnote contents to the console.
console.log(footnote.getFootnoteContents().getText());

ফেরত

Footnote[] |null — ট্যাবটির পাদটীকাসমূহ।

অনুমোদন

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

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

getHeader()

ট্যাবটির হেডার সেকশন পুনরুদ্ধার করে, যদি তা বিদ্যমান থাকে। 

// Opens the Docs file and retrieves the tab by its IDs. If you created your
// script from within a Google Docs file, you can use
// DocumentApp.getActiveDocument().getActiveTab() instead.
// TODO(developer): Replace the IDs with your own.
const documentTab =
    DocumentApp.openById('123abc').getTab('123abc').asDocumentTab();

// Gets the text of the tab's header and logs it to the console.
console.log(documentTab.getHeader().getText());

ফেরত

HeaderSection |null — ট্যাবটির হেডার।

অনুমোদন

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

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

getNamedRangeById(id)

প্রদত্ত আইডি সহ NamedRange খুঁজে বের করে। ট্যাবে এই ধরনের কোনো NamedRange না থাকলে এই মেথডটি null রিটার্ন করে। নামগুলো সবসময় অনন্য হয় না, এমনকি একাধিক ট্যাবের মধ্যেও; একই ডকুমেন্টের বিভিন্ন রেঞ্জের একই নাম থাকতে পারে, অনেকটা HTML-এর ক্লাসের মতো। এর বিপরীতে, আইডিগুলো ট্যাবের মধ্যে অনন্য হয়, যেমনটা HTML-এর আইডির ক্ষেত্রে হয়।

প্যারামিটার

নাম প্রকার বর্ণনা
id String রেঞ্জের আইডি, যা ট্যাবের মধ্যে অনন্য।

ফেরত

NamedRange |null — প্রদত্ত আইডি-সহ NamedRange , অথবা ট্যাবে এই ধরনের কোনো রেঞ্জ না থাকলে null ।

অনুমোদন

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

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

getNamedRanges()

ট্যাবে থাকা সমস্ত NamedRange অবজেক্ট পেয়ে যায়।

যে কোনো স্ক্রিপ্ট যা ট্যাব অ্যাক্সেস করে, তা একটি NamedRange অ্যাক্সেস করতে পারে। স্ক্রিপ্টগুলোর মধ্যে অনাকাঙ্ক্ষিত দ্বন্দ্ব এড়াতে, রেঞ্জের নামের আগে একটি অনন্য স্ট্রিং যুক্ত করার কথা বিবেচনা করুন।

ফেরত

NamedRange[] — ট্যাবে থাকা NamedRange অবজেক্টগুলোর একটি অ্যারে, যেখানে একই নামের একাধিক রেঞ্জ অন্তর্ভুক্ত থাকতে পারে।

অনুমোদন

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

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

getNamedRanges(name)

ট্যাবে থাকা প্রদত্ত নামের সমস্ত NamedRange অবজেক্ট পাওয়া যায়। নামগুলো সবসময় অনন্য হয় না, এমনকি একাধিক ট্যাবের মধ্যেও; একই ডকুমেন্টের বিভিন্ন রেঞ্জের নাম একই হতে পারে, অনেকটা HTML-এর ক্লাসের মতো। এর বিপরীতে, ID-গুলো ট্যাবের মধ্যে অনন্য হয়, যেমনটা HTML-এর ID হয়ে থাকে।

যে কোনো স্ক্রিপ্ট যা ট্যাব অ্যাক্সেস করে, তা একটি NamedRange অ্যাক্সেস করতে পারে। স্ক্রিপ্টগুলোর মধ্যে অনাকাঙ্ক্ষিত দ্বন্দ্ব এড়াতে, রেঞ্জের নামের আগে একটি অনন্য স্ট্রিং যুক্ত করার কথা বিবেচনা করুন।

প্যারামিটার

নাম প্রকার বর্ণনা
name String রেঞ্জটির নাম, যা অগত্যা অনন্য নয়।

ফেরত

NamedRange[] — প্রদত্ত নামের ট্যাবে থাকা NamedRange অবজেক্টগুলোর একটি অ্যারে।

অনুমোদন

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

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

newPosition(element, offset)

একটি নতুন Position তৈরি করে, যা একটি নির্দিষ্ট এলিমেন্টের সাপেক্ষে ট্যাবের কোনো একটি অবস্থানের রেফারেন্স। অন্যান্য ব্যবহারের পাশাপাশি, ব্যবহারকারীর কার্সরকেও একটি Position হিসেবে উপস্থাপন করা হয়। 

// Append a paragraph, then place the user's cursor after the first word of the
// new paragraph.
// TODO(developer): Replace the IDs with your own.
const doc = DocumentApp.openById('123abc');
const documentTab = doc.getTab('123abc').asDocumentTab();
const paragraph = documentTab.getBody().appendParagraph('My new paragraph.');
const position = documentTab.newPosition(paragraph.getChild(0), 2);
doc.setCursor(position);

প্যারামিটার

নাম প্রকার বর্ণনা
element Element যে এলিমেন্টটি নতুন তৈরি করা Position টিকে ধারণ করে; সেটি অবশ্যই একটি Text এলিমেন্ট অথবা Paragraph মতো একটি কন্টেইনার এলিমেন্ট হতে হবে।
offset Integer Text এলিমেন্টের ক্ষেত্রে, Position এর আগের অক্ষর সংখ্যা; অন্যান্য এলিমেন্টের ক্ষেত্রে, একই কন্টেইনার এলিমেন্টের মধ্যে Position এর আগের চাইল্ড এলিমেন্টের সংখ্যা।

ফেরত

Position — নতুন Position ।

অনুমোদন

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

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

newRange()

ট্যাব এলিমেন্ট থেকে Range অবজেক্ট তৈরি করতে ব্যবহৃত একটি বিল্ডার তৈরি করে। 

// Change the user's selection to a range that includes every table in the tab.
// TODO(developer): Replace the IDs with your own.
const doc = DocumentApp.openById('123abc');
const documentTab = doc.getTab('123abc').asDocumentTab();
const rangeBuilder = documentTab.newRange();
const tables = documentTab.getBody().getTables();
for (let i = 0; i < tables.length; i++) {
  rangeBuilder.addElement(tables[i]);
}
doc.setSelection(rangeBuilder.build());

ফেরত

RangeBuilder — নতুন নির্মাতা।

অনুমোদন

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

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