Ein Layoutelement, das den Anfang einer Seite markiert. Elemente können über ein Form
erstellt oder aufgerufen 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 am Ende des Formulars an. |
getGoToPage() | PageBreakItem | Ruft die PageBreakItem ab, zu der das Formular nach dem Ausfüllen der Seite davor springt
Seitenumbruch (d. h. beim Erreichen dieses Seitenumbruchs durch den normalen linearen Verlauf durch den
. |
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 Kennzeichnung des Artikels ab. |
getIndex() | Integer | Ruft den Index des Elements unter allen Elementen im Formular ab. |
getPageNavigationType() | PageNavigationType | Ruft den Typ der Seitennavigation ab, die nach dem Fertigstellen der Seite vor diesem Seitenumbruch erfolgt (d. h. nach dem Erreichen dieses Seitenumbruchs durch den normalen linearen Fortschritt im Formular). |
getTitle() | String | Ruft den Titel des Elements ab. Wird manchmal als Überschrifttext bezeichnet, im Fall von SectionHeaderItem . |
getType() | ItemType | Ruft den Typ des Elements ab, dargestellt als ItemType . |
setGoToPage(goToPageItem) | PageBreakItem | Legt fest, zu welcher Seite springen soll, nachdem sie vor diesem Seitenumbruch abgeschlossen wurde (d. h. nach das Erreichen dieses Seitenumbruchs durch den normalen linearen Verlauf des Formulars). |
setGoToPage(navigationType) | PageBreakItem | Legt die Art der Seitennavigation fest, die nach dem Fertigstellen der Seite vor diesem Seitenumbruch stattfindet (d. h. nach dem Erreichen dieses Seitenumbruchs durch den normalen linearen Fortschritt im Formular). |
setHelpText(text) | PageBreakItem | Legt den Hilfetext des Elements fest (wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems , PageBreakItems und SectionHeaderItems bezeichnet). |
setTitle(title) | PageBreakItem | Legt den Titel des Elements fest (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem ). |
Detaillierte Dokumentation
duplicate()
Erstellt eine Kopie dieses Elements und hängt sie am Ende des Formulars an.
Rückflug
PageBreakItem
– ein Duplikat von 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
getGoToPage()
Ruft die PageBreakItem
ab, zu der das Formular nach dem Ausfüllen der Seite davor springt
Seitenumbruch (d. h. beim Erreichen dieses Seitenumbruchs durch den normalen linearen Verlauf durch den
.
Rückflug
PageBreakItem
: der Seitenumbruch, zu dem nach dem Ende der Seite vor diesem Seitenumbruch 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()
Ruft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
bezeichnet.
Rückflug
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 Kennzeichnung des Artikels ab.
Rückflug
Integer
: die 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 unter allen Elementen im Formular ab.
Rückflug
Integer
– 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. Wird manchmal als Überschrifttext bezeichnet, im Fall von SectionHeaderItem
.
Rückflug
String
: Titel oder Text der Überschrift 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
.
Rückflug
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 springen soll, nachdem sie vor diesem Seitenumbruch abgeschlossen wurde (d. h. nach
das Erreichen dieses Seitenumbruchs durch den normalen linearen Verlauf des Formulars). Wenn die vorherige Seite
eine MultipleChoiceItem
oder ListItem
mit einer Navigationsoption enthielt, die
diese Navigation überschreibt.
Parameter
Name | Typ | Beschreibung |
---|---|---|
goToPageItem | PageBreakItem | Der Seitenumbruch, zu dem nach Abschluss der Seite vor diesem Seitenumbruch springen soll |
Rückflug
PageBreakItem
– diese 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 (wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems
, PageBreakItems
und SectionHeaderItems
bezeichnet).
Parameter
Name | Typ | Beschreibung |
---|---|---|
text | String | den neuen Hilfetext |
Rückflug
PageBreakItem
– diese 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 (manchmal als Überschrifttext bezeichnet, im Falle eines SectionHeaderItem
).
Parameter
Name | Typ | Beschreibung |
---|---|---|
title | String | den neuen Titel oder Überschriftentext |
Rückflug
PageBreakItem
– diese 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