Class PageBreakItem

PageBreakItem

Ein Layoutelement, das den Beginn einer Seite markiert. Auf Elemente kann über eine Form zugegriffen oder sie können über eine Form erstellt werden. 

// Create a form and add three page-break items.
const form = FormApp.create('Form Name');
const pageTwo = form.addPageBreakItem().setTitle('Page Two');
const 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 fügt sie am Ende des Formulars ein.
getGoToPage()PageBreakItemRuft die PageBreakItem ab, zu der das Formular nach Abschluss der Seite vor diesem Seitenumbruch springt (d. h. wenn dieser Seitenumbruch durch normale lineare Bearbeitung des Formulars erreicht wird).
getHelpText()StringRuft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
getId()IntegerRuft die eindeutige Kennung des Elements ab.
getIndex()IntegerRuft den Index des Elements unter allen Elementen im Formular ab.
getPageNavigationType()PageNavigationTypeRuft den Typ der Seitennavigation ab, die nach dem Ausfüllen der Seite vor diesem Seitenumbruch erfolgt (d. h. wenn dieser Seitenumbruch durch normalen linearen Fortschritt durch das Formular erreicht wird).
getTitle()StringRuft den Titel des Elements ab (bei einem SectionHeaderItem manchmal auch als Header-Text bezeichnet).
getType()ItemTypeRuft den Typ des Elements als ItemType ab.
setGoToPage(goToPageItem)PageBreakItemLegt die Seite fest, zu der gesprungen werden soll, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde (d. h. wenn dieser Seitenumbruch durch normales lineares Durchlaufen des Formulars erreicht wird).
setGoToPage(navigationType)PageBreakItemLegt den Typ der Seitennavigation fest, die nach Abschluss der Seite vor diesem Seitenumbruch erfolgt (d. h. wenn dieser Seitenumbruch durch normalen linearen Fortschritt durch das Formular erreicht wird).
setHelpText(text)PageBreakItemLegt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
setTitle(title)PageBreakItemLegt den Titel des Elements fest (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).

Detaillierte Dokumentation

duplicate()

Erstellt eine Kopie dieses Elements und fügt sie am Ende des Formulars ein.

Rückflug

PageBreakItem – ein Duplikat dieses PageBreakItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getGoToPage()

Ruft die PageBreakItem ab, zu der das Formular nach Abschluss der Seite vor diesem Seitenumbruch springt (d. h. wenn dieser Seitenumbruch durch normale lineare Bearbeitung des Formulars erreicht wird).

Rückflug

PageBreakItem – der Seitenumbruch, zu dem gesprungen werden soll, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde, oder null, wenn keiner festgelegt ist

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getHelpText()

Ruft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Rückflug

String – der Hilfetext oder die Beschreibung des Artikels

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getId()

Ruft die eindeutige Kennung des Elements ab.

Rückflug

Integer: die ID des Artikels

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • 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: der Index des Elements

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getPageNavigationType()

Ruft den Typ der Seitennavigation ab, die nach dem Ausfüllen der Seite vor diesem Seitenumbruch erfolgt (d. h. wenn dieser Seitenumbruch durch normalen linearen Fortschritt durch das Formular erreicht wird).

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getTitle()

Ruft den Titel des Elements ab (bei einem SectionHeaderItem manchmal auch als Header-Text bezeichnet).

Rückflug

String – der Titel oder Headertext des Elements

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

getType()

Ruft den Typ des Elements als ItemType ab.

Rückflug

ItemType: Der Typ des Artikels.

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setGoToPage(goToPageItem)

Legt die Seite fest, zu der gesprungen werden soll, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde (d. h. wenn dieser Seitenumbruch durch normales lineares Durchlaufen des Formulars erreicht wird). Wenn die vorherige Seite ein MultipleChoiceItem oder ListItem mit einer Navigationsoption enthielt, wird diese Navigation überschrieben.

Parameter

NameTypBeschreibung
goToPageItemPageBreakItemDer Seitenumbruch, zu dem gesprungen werden soll, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde

Rückflug

PageBreakItem – diese PageBreakItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setGoToPage(navigationType)

Legt den Typ der Seitennavigation fest, die nach Abschluss der Seite vor diesem Seitenumbruch erfolgt (d. h. wenn dieser Seitenumbruch durch normalen linearen Fortschritt durch das Formular erreicht wird). Wenn die Seite ein MultipleChoiceItem oder ListItem mit einer Navigationsoption enthielt, wird diese Navigation verwendet.

Parameter

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

Rückflug

PageBreakItem – diese PageBreakItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setHelpText(text)

Legt den Hilfetext des Elements fest (manchmal auch als Beschreibungstext für Layout-Elemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Parameter

NameTypBeschreibung
textStringder neue Hilfetext

Rückflug

PageBreakItem – diese PageBreakItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms

setTitle(title)

Legt den Titel des Elements fest (bei einem SectionHeaderItem manchmal auch als Überschrift bezeichnet).

Parameter

NameTypBeschreibung
titleStringden neuen Titel oder Headertext

Rückflug

PageBreakItem – diese PageBreakItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, benötigen eine Autorisierung für mindestens einen der folgenden Zugriffsbereiche:

  • https://www.googleapis.com/auth/forms.currentonly
  • https://www.googleapis.com/auth/forms