本頁面由 Cloud Translation API 翻譯而成。

Class 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