Class Tab

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

Methods

שיטהסוג הערך שמוחזרתיאור קצר
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