Class Tab

علامة التبويب

علامة تبويب ضمن مستند "مستندات Google" 

// 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');

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
asDocumentTab()DocumentTabيسترجع محتوى علامة التبويب كDocumentTab.
getChildTabs()Tab[]يسترجع علامات التبويب الفرعية المُدمجة في علامة التبويب هذه.
getId()Stringيسترجع معرّف علامة التبويب.
getIndex()Integerيسترجع الفهرس المستند إلى 0 لعلامة التبويب ضمن العنصر الرئيسي.
getTitle()Stringيسترجع عنوان علامة التبويب.
getType()TabTypeيستردّ نوع علامة التبويب.

مستندات تفصيلية

asDocumentTab()

يسترجع محتوى علامة التبويب كDocumentTab.

الإرجاع

DocumentTab: علامة التبويب على شكل DocumentTab.

getChildTabs()

يسترجع علامات التبويب الفرعية المُدمجة في علامة التبويب هذه.

الإرجاع

Tab[] - علامات التبويب الفرعية المُدمجة في علامة التبويب هذه

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

getId()

يسترجع معرّف علامة التبويب.

الإرجاع

String: رقم تعريف علامة التبويب

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

getIndex()

يسترجع الفهرس المستند إلى 0 لعلامة التبويب ضمن العنصر الرئيسي.

الإرجاع

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