A layout item that marks the start of a page. Items can be accessed or
created from a 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
Methods
Method | Return type | Brief description |
---|---|---|
duplicate() | PageBreakItem | Creates a copy of this item and appends it to the end of the form. |
getGoToPage() | PageBreakItem | Gets the PageBreakItem that the form will jump to after completing the page before this
page break (that is, upon reaching this page break by normal linear progression through the
form). |
getHelpText() | String | Gets the item's help text (sometimes called description text for layout
items like ImageItems ,
PageBreakItems , and
SectionHeaderItems ). |
getId() | Integer | Gets the item's unique identifier. |
getIndex() | Integer | Gets the index of the item among all the items in the form. |
getPageNavigationType() | PageNavigationType | Gets the type of page navigation that occurs after completing the page before this page break (that is, upon reaching this page break by normal linear progression through the form). |
getTitle() | String | Gets the item's title (sometimes called header text, in the case of a
SectionHeaderItem ). |
getType() | ItemType | Gets the item's type, represented as an ItemType . |
setGoToPage(goToPageItem) | PageBreakItem | Sets the page to jump to after completing the page before this page break (that is, upon reaching this page break by normal linear progression through the form). |
setGoToPage(navigationType) | PageBreakItem | Sets the type of page navigation that occurs after completing the page before this page break (that is, upon reaching this page break by normal linear progression through the form). |
setHelpText(text) | PageBreakItem | Sets the item's help text (sometimes called description text for layout
items like ImageItems ,
PageBreakItems , and
SectionHeaderItems ). |
setTitle(title) | PageBreakItem | Sets the item's title (sometimes called header text, in the case of a
SectionHeaderItem ). |
Detailed documentation
duplicate()
Creates a copy of this item and appends it to the end of the form.
Return
PageBreakItem
— a duplicate of this PageBreakItem
, for chaining
getGoToPage()
Gets the PageBreakItem
that the form will jump to after completing the page before this
page break (that is, upon reaching this page break by normal linear progression through the
form).
Return
PageBreakItem
— the page break to jump to after completing the page before this page break, or
null
if none is set
getHelpText()
Gets the item's help text (sometimes called description text for layout
items like ImageItems
,
PageBreakItems
, and
SectionHeaderItems
).
Return
String
— the item's help text or description text
getId()
Gets the item's unique identifier.
Return
Integer
— the item's ID
getIndex()
Gets the index of the item among all the items in the form.
Return
Integer
— the index of the item
getTitle()
Gets the item's title (sometimes called header text, in the case of a
SectionHeaderItem
).
Return
String
— the item's title or header text
setGoToPage(goToPageItem)
Sets the page to jump to after completing the page before this page break (that is, upon
reaching this page break by normal linear progression through the form). If the previous
page contained a MultipleChoiceItem
or ListItem
with a navigation option, that
navigation overrules this navigation.
Parameters
Name | Type | Description |
---|---|---|
goToPageItem | PageBreakItem | the page break to jump to after completing the page before this page break |
Return
PageBreakItem
— this PageBreakItem
, for chaining
setHelpText(text)
Sets the item's help text (sometimes called description text for layout
items like ImageItems
,
PageBreakItems
, and
SectionHeaderItems
).
Parameters
Name | Type | Description |
---|---|---|
text | String | the new help text |
Return
PageBreakItem
— this PageBreakItem
, for chaining
setTitle(title)
Sets the item's title (sometimes called header text, in the case of a
SectionHeaderItem
).
Parameters
Name | Type | Description |
---|---|---|
title | String | the new title or header text |
Return
PageBreakItem
— this PageBreakItem
, for chaining