Class PageBreakItem

PageBreakItem

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

MethodeRückgabetypKurzbeschreibung
duplicate()PageBreakItemErstellt eine Kopie dieses Elements und hängt es an das Ende des Formulars an.
getGoToPage()PageBreakItemRuft 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()StringRuft den Hilfetext des Elements ab. Dieser wird manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet.
getId()IntegerRuft die eindeutige Kennung des Elements ab.
getIndex()IntegerRuft den Index des Elements aus allen Elementen im Formular ab.
getPageNavigationType()PageNavigationTypeRuft 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()StringRuft den Titel des Elements ab. Dieser wird manchmal als Headertext bezeichnet, falls SectionHeaderItem.
getType()ItemTypeRuft den Elementtyp ab, dargestellt als ItemType.
setGoToPage(goToPageItem)PageBreakItemLegt 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)PageBreakItemLegt 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)PageBreakItemLegt den Hilfetext des Elements fest (manchmal auch Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems).
setTitle(title)PageBreakItemLegt 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

getPageNavigationType()

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.

Zurücksenden

PageNavigationType: die Navigationsaktion, die nach Abschluss der Seite vor diesem Seitenumbruch ausgeführt werden soll

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

NameTypBeschreibung
goToPageItemPageBreakItemSeitenumbruch, 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

setGoToPage(navigationType)

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. Wenn die Seite ein MultipleChoiceItem oder ListItem mit einer Navigationsoption enthält, hat diese Navigation Vorrang vor dieser Navigation.

Parameter

NameTypBeschreibung
navigationTypePageNavigationTypedie Navigationsaktion, die nach Abschluss der Seite vor diesem Seitenumbruch ausgeführt werden soll

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

NameTypBeschreibung
textStringden 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

NameTypBeschreibung
titleStringden 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