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

擷取分頁類型。

請使用這個方法判斷這個 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