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 הזה לפני שמבצעים העברה (cast) לסוג הספציפי יותר באמצעות 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