Ein Layoutelement, das den Anfang einer Seite markiert. Elemente können über ein Form aufgerufen oder erstellt werden.
// 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
Methoden
| Methode | Rückgabetyp | Kurzbeschreibung |
|---|---|---|
duplicate() | PageBreakItem | Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an. |
getGoToPage() | PageBreakItem | Ruft die PageBreakItem ab, zu der das Formular springen kann, nachdem die Seite vor diesem Seitenumbruch ausgefüllt wurde (d. h. nach Erreichen dieses Seitenumbruchs durch den linearen Verlauf durch das Formular). |
getHelpText() | String | Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet. |
getId() | Integer | Ruft die eindeutige Kennung des Elements ab. |
getIndex() | Integer | Ruft den Index des Elements aus allen Elementen im Formular ab. |
getPageNavigationType() | PageNavigationType | Ruft den Typ der Seitennavigation ab, die ausgeführt wird, nachdem die Seite vor dem Seitenumbruch abgeschlossen wurde, d. h. beim Erreichen dieses Seitenumbruchs durch den linearen Verlauf durch das Formular. |
getTitle() | String | Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem. |
getType() | ItemType | Ruft den Elementtyp ab, dargestellt als ItemType. |
setGoToPage(goToPageItem) | PageBreakItem | Legt fest, zu welcher Seite gewechselt werden soll, nachdem die Seite vor dem Seitenumbruch (d. h. beim Erreichen des Seitenumbruchs durch den linearen Verlauf über das Formular) abgeschlossen wurde. |
setGoToPage(navigationType) | PageBreakItem | Legt den Typ der Seitennavigation fest, die nach dem Ausfüllen der Seite vor diesem Seitenumbruch erfolgt, also wenn dieser Seitenumbruch durch normale lineare Verlaufsbewegungen durch das Formular erreicht wird. |
setHelpText(text) | PageBreakItem | Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems). |
setTitle(title) | PageBreakItem | Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem) |
Detaillierte Dokumentation
duplicate()
Erstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an.
Zurücksenden
PageBreakItem: ein Duplikat dieses PageBreakItem, für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getGoToPage()
Ruft die PageBreakItem ab, zu der das Formular springen kann, nachdem die Seite vor diesem Seitenumbruch ausgefüllt wurde (d. h. nach Erreichen dieses Seitenumbruchs durch den linearen Verlauf durch das Formular).
Zurücksenden
PageBreakItem: Der Seitenumbruch, zu dem springen soll, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde, oder null, wenn keiner festgelegt ist
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getHelpText()
Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet.
Zurücksenden
String: der Hilfe- oder Beschreibungstext des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige Kennung des Elements ab.
Zurücksenden
Integer: die ID des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getIndex()
Ruft den Index des Elements aus allen Elementen im Formular ab.
Zurücksenden
Integer: Der Index des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem.
Zurücksenden
String: Titel oder Titel des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
Ruft den Elementtyp ab, dargestellt als ItemType.
Zurücksenden
ItemType: Typ des Elements
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGoToPage(goToPageItem)
Legt fest, zu welcher Seite gewechselt werden soll, nachdem die Seite vor dem Seitenumbruch (d. h. beim Erreichen des Seitenumbruchs durch den linearen Verlauf über das Formular) abgeschlossen wurde. Wenn die vorherige Seite eine MultipleChoiceItem oder ListItem mit einer Navigationsoption enthielt, hat diese Navigation Vorrang vor dieser Navigation.
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
goToPageItem | PageBreakItem | Seitenumbruch, an dem der Nutzer nach Abschluss der Seite vor dem Seitenumbruch springen kann |
Zurücksenden
PageBreakItem – dieser PageBreakItem für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems).
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
text | String | den neuen Hilfetext |
Zurücksenden
PageBreakItem – dieser PageBreakItem für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest (manchmal auch Headertext bei SectionHeaderItem)
Parameter
| Name | Typ | Beschreibung |
|---|---|---|
title | String | den neuen Titel oder Titel |
Zurücksenden
PageBreakItem – dieser PageBreakItem für Verkettung
Autorisierung
Für Skripts, die diese Methode verwenden, ist eine Autorisierung in mindestens einem der folgenden Bereiche erforderlich:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms