Class Tab

تب

یک برگه در یک سند Google Docs.

// Get all of the first-level tabs (tabs that are not nested within a parent
// tab) in the document.
// TODO(developer): Replace the ID with your own.
const tabs = DocumentApp.openById('123abc').getTabs();

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

روش‌ها

روش نوع بازگشتی شرح مختصر
as Document Tab() Document Tab محتوای تب را به عنوان یک Document Tab بازیابی می‌کند.
get Child Tabs() Tab[] تب‌های فرزندِ تودرتو درون این تب را بازیابی می‌کند.
get Id() String شناسه (ID) برگه (tab) را بازیابی می‌کند.
get Index() Integer ایندکس مبتنی بر ۰ تب درون والد را بازیابی می‌کند.
get Title() String عنوان برگه را بازیابی می‌کند.
get Type() Tab Type نوع تب را بازیابی می‌کند.

مستندات دقیق

asDocumentTab()

محتوای تب را به عنوان یک DocumentTab بازیابی می‌کند.

بازگشت

DocumentTab — تبی به عنوان DocumentTab .

getChildTabs()

تب‌های فرزندِ تودرتو درون این تب را بازیابی می‌کند.

بازگشت

Tab[] — تب‌های فرزند که درون این تب قرار گرفته‌اند.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

getId()

شناسه (ID) برگه (tab) را بازیابی می‌کند.

بازگشت

String - شناسه برگه.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

getIndex()

ایندکس مبتنی بر ۰ تب درون والد را بازیابی می‌کند.

بازگشت

Integer - اندیس تب درون والد.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

getTitle()

عنوان برگه را بازیابی می‌کند.

بازگشت

String - عنوان برگه.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

getType()

نوع تب را بازیابی می‌کند.

از این متد برای تعیین نوع محتوای این Tab قبل از تبدیل به نوع خاص‌تر با استفاده از asDocumentTab() استفاده کنید.

const tab = DocumentApp.getActiveDocument().getActiveTab();
// Use getType() to determine the tab's type before casting.
if (tab.getType() === DocumentApp.TabType.DOCUMENT_TAB) {
  // It's a document tab, write some text to it.
  tab.asDocumentTab().setText('Hello World!');
} else {
  // There are currently no types other than DOCUMENT_TAB.
}

بازگشت

TabType — نوع برگه.

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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