本頁面由 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()`

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

Return 鍵

PageBreakItem：與這個 PageBreakItem 重複，用於鏈結

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`getGoToPage()`

取得在完成分頁符號之後，表單從該頁面跳至的 PageBreakItem (意即透過表單取得一般線性進度為止)。

Return 鍵

PageBreakItem - 在頁面符號結束後，完成頁面符號的情況下跳至頁面切換；若未設定，則會跳至 null。

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`getHelpText()`

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

Return 鍵

String：項目的說明文字或說明文字

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`getId()`

取得商品的專屬 ID。

Return 鍵

Integer：該項目的 ID

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`getIndex()`

取得表單中所有商品的索引。

Return 鍵

Integer：項目的索引

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`getPageNavigationType()`

取得在完成分頁符號之後 (意即透過表單正常進行線性分頁抵達該分頁後) 發生的頁面導覽類型。

Return 鍵

PageNavigationType — 於此分頁符號到期前完成網頁須採取的動作

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`getTitle()`

取得商品標題 (有時為 SectionHeaderItem 標頭)。

Return 鍵

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

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`getType()`

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

Return 鍵

ItemType：項目類型

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`setGoToPage(goToPageItem)`

將頁面設為在完成分頁符號前 (例如透過表單以一般線性進度到達頁面符號) 後跳到的頁面。如果前一個頁麵包含有導覽選項的 MultipleChoiceItem 或 ListItem，該導覽將會覆寫此導覽。

參數

名稱	類型	說明
`goToPageItem`	`PageBreakItem`	這一步是在完成分頁符號之後，繼續切換分頁符號

Return 鍵

PageBreakItem — 這個 PageBreakItem 用於鏈結

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`setGoToPage(navigationType)`

設定在完成頁面符號之前 (意即透過表單以一般線性進度到達該網頁分頁時) 發生的頁面瀏覽類型。如果頁麵包含具有導覽選項的 MultipleChoiceItem 或 ListItem，該導覽會高於此導覽。

參數

名稱	類型	說明
`navigationType`	`PageNavigationType`	請先在這個頁面完成動作前完成的導覽動作

Return 鍵

PageBreakItem — 這個 PageBreakItem 用於鏈結

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`setHelpText(text)`

設定項目的說明文字 (有時是指 ImageItems、PageBreakItems 和 SectionHeaderItems 等版面配置項目的說明文字)。

參數

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

Return 鍵

PageBreakItem — 這個 PageBreakItem 用於鏈結

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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

`setTitle(title)`

設定項目標題 (有時在 SectionHeaderItem 中稱為標題文字)。

參數

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

Return 鍵

PageBreakItem — 這個 PageBreakItem 用於鏈結

授權

如果指令碼使用這個方法，就必須符合下列一或多個範圍的授權：

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