此页面由 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`	获取商品的唯一标识符。
`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()`

获取商品的唯一标识符。

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