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	检索标签页的 ID。
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()

检索标签页的 ID。

返回

String - 标签页的 ID。

授权

使用此方法的脚本需要获得以下一个或多个范围的授权：

• 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()

检索标签页的类型。

在使用 asDocumentTab() 转换为更具体的类型之前，请使用此方法确定此 Tab 的内容类型。

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