Ein Layoutelement, das den Anfang einer Seite markiert. Elemente können über 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 sie an das Ende des Formulars an. |
getGoToPage() | PageBreakItem | Ruft die PageBreakItem ab, zu der das Formular nach dem Ausfüllen der Seite vor diesem Seitenumbruch springt, d. h. beim Erreichen des Seitenumbruchs durch den normalen linearen Verlauf des Formulars. |
getHelpText() | String | den Hilfetext des Elements abrufen (manchmal als Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems bezeichnet) |
getId() | Integer | Ruft die eindeutige ID des Artikels ab. |
getIndex() | Integer | Ruft den Index des Elements aus allen Elementen im Formular ab. |
getPageNavigationType() | PageNavigationType | Ruft den Seitennavigationstyp ab, der nach dem Abschluss der Seite vor diesem Seitenumbruch erfolgt, d. h. beim Erreichen des Seitenumbruchs durch den normalen linearen Verlauf des Formulars. |
getTitle() | String | Ruft den Titel des Elements ab (im Fall eines SectionHeaderItem -Elements manchmal auch als Überschrifttext bezeichnet). |
getType() | ItemType | Ruft den Typ des Elements ab, dargestellt als ItemType . |
setGoToPage(goToPageItem) | PageBreakItem | Legt fest, zu welcher Seite nach dem Abschluss vor diesem Seitenumbruch gesprungen werden soll, d. h. wenn der Seitenumbruch durch den normalen linearen Verlauf des Formulars erreicht wird. |
setGoToPage(navigationType) | PageBreakItem | Legt die Art der Seitennavigation fest, die nach dem Abschließen der Seite vor diesem Seitenumbruch erfolgt, d. h. wenn dieser Seitenumbruch durch den normalen linearen Verlauf des Formulars erreicht wird. |
setHelpText(text) | PageBreakItem | Legt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems , PageBreakItems und SectionHeaderItems wird dieser Text manchmal auch als Beschreibungstext bezeichnet. |
setTitle(title) | PageBreakItem | Legt den Titel des Elements fest. Bei SectionHeaderItem wird dieser Text manchmal auch als Überschrifttext bezeichnet. |
Detaillierte Dokumentation
duplicate()
Erstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an.
Return
PageBreakItem
– ein Duplikat dieses PageBreakItem
für die Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGoToPage()
Ruft die PageBreakItem
ab, zu der das Formular nach dem Ausfüllen der Seite vor diesem Seitenumbruch springt, d. h. beim Erreichen des Seitenumbruchs durch den normalen linearen Verlauf des Formulars.
Return
PageBreakItem
: der Seitenumbruch, zu dem nach Abschluss des Seitenumbruchs gewechselt werden soll, oder null
, wenn keiner festgelegt ist
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
den Hilfetext des Elements abrufen (manchmal als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
bezeichnet)
Return
String
: Hilfe- oder Beschreibungstext des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Ruft die eindeutige ID des Artikels ab.
Return
Integer
: ID des Artikels
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
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.
Return
Integer
: der Index des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Ruft den Titel des Elements ab (im Fall eines SectionHeaderItem
-Elements manchmal auch als Überschrifttext bezeichnet).
Return
String
: Titel oder Überschriftentext des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Ruft den Typ des Elements ab, dargestellt als ItemType
.
Return
ItemType
: Typ des Elements
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGoToPage(goToPageItem)
Legt fest, zu welcher Seite nach dem Abschluss vor diesem Seitenumbruch gesprungen werden soll, d. h. wenn der Seitenumbruch durch den normalen linearen Verlauf des Formulars erreicht wird. Wenn die vorherige Seite ein MultipleChoiceItem
oder ListItem
mit einer Navigationsoption enthielt, überschreibt die Navigation diese Navigation.
Parameter
Name | Typ | Beschreibung |
---|---|---|
goToPageItem | PageBreakItem | der Seitenumbruch, zu dem nach Abschluss des Seitenumbruchs gewechselt werden soll |
Return
PageBreakItem
– dieses PageBreakItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Legt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems
, PageBreakItems
und SectionHeaderItems
wird dieser Text manchmal auch als Beschreibungstext bezeichnet.
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | dem neuen Hilfetext |
Return
PageBreakItem
– dieses PageBreakItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Legt den Titel des Elements fest. Bei SectionHeaderItem
wird dieser Text manchmal auch als Überschrifttext bezeichnet.
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | dem neuen Titel oder Text der Überschrift |
Return
PageBreakItem
– dieses PageBreakItem
für Verkettung
Autorisierung
Skripts, die diese Methode verwenden, erfordern eine Autorisierung mit einem oder mehreren der folgenden Bereiche:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms