Class PageBreakItem

PageBreakItem

標示頁面開頭的版面配置項目。您可以透過 Form 存取或建立項目。

// Create a form and add three page-break items.
const form = FormApp.create('Form Name');
const pageTwo = form.addPageBreakItem().setTitle('Page Two');
const pageThree = form.addPageBreakItem().setTitle('Page Three');

// Make the first two pages navigate elsewhere upon completion.
pageTwo.setGoToPage(
    pageThree);  // At end of page one (start of page two), jump to page three
pageThree.setGoToPage(
    FormApp.PageNavigationType.RESTART);  // At end of page two, restart form

方法

方法	傳回類型	簡短說明
duplicate()	PageBreakItem	建立這個項目的副本，並附加到表單結尾。
getGoToPage()	PageBreakItem	取得表單在完成這個分頁符號前的頁面後，會跳轉到的 PageBreakItem (也就是透過表單的正常線性進度到達這個分頁符號時)。
getHelpText()	String	取得項目的說明文字 (有時稱為版面配置項目的說明文字，例如 ImageItems、PageBreakItems 和 SectionHeaderItems)。
getId()	Integer	取得項目的專屬 ID。
getIndex()	Integer	取得表單中所有項目中的項目索引。
getPageNavigationType()	PageNavigationType	取得在此分頁符號之前完成頁面後發生的網頁瀏覽類型 (也就是透過表單正常線性進展到達此分頁符號時)。
getTitle()	String	取得項目的標題 (如果是 SectionHeaderItem，有時稱為標頭文字)。
getType()	ItemType	取得項目的類型，以 ItemType 表示。
setGoToPage(goToPageItem)	PageBreakItem	設定在完成這個分頁符號前的頁面後，要跳轉到的頁面 (也就是透過表單的正常線性進度到達這個分頁符號時)。
setGoToPage(navigationType)	PageBreakItem	設定在此分頁符號前完成頁面後發生的網頁瀏覽類型 (也就是透過表單的正常線性進度到達此分頁符號時)。
setHelpText(text)	PageBreakItem	設定項目的說明文字 (有時稱為版面配置項目的說明文字，例如 ImageItems、PageBreakItems 和 SectionHeaderItems)。
setTitle(title)	PageBreakItem	設定項目的標題 (如果是 SectionHeaderItem，有時稱為標頭文字)。

內容詳盡的說明文件

duplicate()

建立這個項目的副本，並附加到表單結尾。

回攻員

PageBreakItem：這個 PageBreakItem 的副本，用於串連

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getGoToPage()

取得表單在完成這個分頁符號前的頁面後，會跳轉到的 PageBreakItem (也就是透過表單的正常線性進度到達這個分頁符號時)。

回攻員

PageBreakItem：分頁符號，完成這個分頁符號前的頁面後，就會跳到這個分頁符號，如果沒有設定分頁符號，則為 null

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getHelpText()

取得項目的說明文字 (有時稱為版面配置項目的說明文字，例如 ImageItems、PageBreakItems 和 SectionHeaderItems)。

回攻員

String：項目的說明文字

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getId()

取得項目的專屬 ID。

回攻員

Integer：商品的 ID

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getIndex()

取得表單中所有項目中的項目索引。

回攻員

Integer：項目的索引

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getPageNavigationType()

取得在此分頁符號之前完成頁面後發生的網頁瀏覽類型 (也就是透過表單正常線性進展到達此分頁符號時)。

回攻員

PageNavigationType：在分頁符號前完成頁面後要採取的導覽動作

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getTitle()

取得項目的標題 (如果是 SectionHeaderItem，有時稱為標頭文字)。

回攻員

String：項目的標題或標頭文字

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

getType()

取得項目的類型，以 ItemType 表示。

回攻員

ItemType：項目的類型

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setGoToPage(goToPageItem)

設定在完成這個分頁符號前的頁面後，要跳轉到的頁面 (也就是透過表單的正常線性進度到達這個分頁符號時)。如果前一頁包含具有導覽選項的 MultipleChoiceItem 或 ListItem，該導覽會覆寫這個導覽。

參數

名稱	類型	說明
goToPageItem	PageBreakItem	完成這個分頁符號前的頁面後，要跳到的分頁符號

回攻員

PageBreakItem - 這是 PageBreakItem，用於鏈結

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setGoToPage(navigationType)

設定完成此分頁符號前的頁面後發生的網頁瀏覽類型 (也就是透過表單的正常線性進度到達此分頁符號時)。如果網頁包含具有導覽選項的 MultipleChoiceItem 或 ListItem，該導覽會覆寫此導覽。

參數

名稱	類型	說明
navigationType	PageNavigationType	完成這個頁面後，在分頁符號前要採取的導覽動作

回攻員

PageBreakItem - 這是 PageBreakItem，用於鏈結

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setHelpText(text)

設定項目的說明文字 (有時稱為版面配置項目的說明文字，例如 ImageItems、PageBreakItems 和 SectionHeaderItems)。

參數

名稱	類型	說明
text	String	新的說明文字

回攻員

PageBreakItem - 這是 PageBreakItem，用於鏈結

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms

---

setTitle(title)

設定項目的標題 (如果是 SectionHeaderItem，有時稱為標頭文字)。

參數

名稱	類型	說明
title	String	新標題或標頭文字

回攻員

PageBreakItem - 這是 PageBreakItem，用於鏈結

授權

使用這個方法的指令碼需要下列一或多個範圍的授權：

• https://www.googleapis.com/auth/forms.currentonly
• https://www.googleapis.com/auth/forms