Class PageBreakItem

PageBreakItem

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

MethodeRückgabetypKurzbeschreibung
duplicate()PageBreakItemErstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an.
getGoToPage()PageBreakItemRuft 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()Stringden Hilfetext des Elements abrufen (manchmal als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet)
getId()IntegerRuft die eindeutige ID des Artikels ab.
getIndex()IntegerRuft den Index des Elements aus allen Elementen im Formular ab.
getPageNavigationType()PageNavigationTypeRuft 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()StringRuft den Titel des Elements ab (im Fall eines SectionHeaderItem-Elements manchmal auch als Überschrifttext bezeichnet).
getType()ItemTypeRuft den Typ des Elements ab, dargestellt als ItemType.
setGoToPage(goToPageItem)PageBreakItemLegt 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)PageBreakItemLegt 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)PageBreakItemLegt den Hilfetext des Elements fest. Bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems wird dieser Text manchmal auch als Beschreibungstext bezeichnet.
setTitle(title)PageBreakItemLegt 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

getPageNavigationType()

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.

Return

PageNavigationType: die Navigationsaktion, die nach dem Abschließen der Seite vor diesem Seitenumbruch ausgeführt werden soll

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

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

setGoToPage(navigationType)

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. Wenn die Seite ein MultipleChoiceItem oder ListItem mit einer Navigationsoption enthielt, überschreibt die Navigation diese Navigation.

Parameter

NameTypBeschreibung
navigationTypePageNavigationTypeDie Navigationsaktion, die nach dem Abschließen der Seite vor diesem Seitenumbruch ausgeführt 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

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

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