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.
var tabs = DocumentApp.openById(DOCUMENT_ID).getTabs();

// Get a specific tab based on the tab ID.
// TODO(developer): Replace the IDs with your own.
var tab = DocumentApp.openById(DOCUMENT_ID).getTab(TAB_ID);

الطُرق

الطريقةنوع الإرجاعوصف قصير
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().

var 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