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

Class PageBreakItem

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

// Create a form and add three page-break items.
var form = FormApp.create('Form Name');
var pageTwo = form.addPageBreakItem().setTitle('Page Two');
var 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