Class PageBreakItem

SeitenUmbruch-Element

Ein Layoutelement, das den Beginn einer Seite markiert. Auf Elemente kann über ein Form zugegriffen oder sie können dort 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 hängt sie an das Ende des Formulars an.
getGoToPage()PageBreakItemRuft die PageBreakItem ab, zu der das Formular springt, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde (d. h., wenn dieser Seitenumbruch durch normale lineare Fortbewegung durch das Formular erreicht wird).
getHelpText()StringRuft den Hilfetext des Elements ab (manchmal auch als Beschreibungstext für Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).
getId()IntegerDie eindeutige Kennung des Artikels.
getIndex()IntegerRuft den Index des Elements unter allen Elementen im Formular ab.
getPageNavigationType()PageNavigationTypeGibt die Art der Seitennavigation an, die nach dem Ausfüllen der Seite vor diesem Seitenumbruch erfolgt (d. h., wenn dieser Seitenumbruch durch normale lineare Fortbewegung durch das Formular erreicht wird).
getTitle()StringDer Titel des Artikels (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).
getType()ItemTypeDer Typ des Artikels, dargestellt als ItemType.
setGoToPage(goToPageItem)PageBreakItemHier legen Sie fest, zu welcher Seite gesprungen werden soll, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde (d. h., wenn dieser Seitenumbruch durch normale lineare Fortbewegung durch das Formular erreicht wird).
setGoToPage(navigationType)PageBreakItemHier legen Sie fest, welche Art der Seitennavigation nach dem Ausfüllen der Seite vor diesem Seitenumbruch erfolgt (d. h., wenn dieser Seitenumbruch durch normale lineare Fortbewegung durch das Formular erreicht wird).
setHelpText(text)PageBreakItemHiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems auch als Beschreibungstext bezeichnet).
setTitle(title)PageBreakItemHiermit wird der Titel des Artikels festgelegt (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).

Detaillierte Dokumentation

duplicate()

Erstellt eine Kopie dieses Elements und hängt sie an das Ende des Formulars an.

Rückflug

PageBreakItem – ein Duplikat dieses PageBreakItem zur Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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 springt, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde (d. h., wenn dieser Seitenumbruch durch normale lineare Fortbewegung durch das Formular erreicht wird).

Rückflug

PageBreakItem: Der Seitenumbruch, zu dem gesprungen werden soll, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde. Andernfalls null.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

  • 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 Layoutelemente wie ImageItems, PageBreakItems und SectionHeaderItems bezeichnet).

Rückflug

String: Hilfetext oder Beschreibung des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getId()

Die eindeutige Kennung des Artikels.

Rückflug

Integer: die Artikel-ID

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere 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: der Index des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getPageNavigationType()

Gibt die Art der Seitennavigation an, die nach dem Ausfüllen der Seite vor diesem Seitenumbruch erfolgt (d. h., wenn dieser Seitenumbruch durch normale lineare Fortbewegung durch das Formular erreicht wird).

Rückflug

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

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getTitle()

Der Titel des Artikels (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).

Rückflug

String – Titel oder Headertext des Artikels

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

getType()

Der Typ des Artikels, dargestellt als ItemType.

Rückflug

ItemType: Der Typ des Artikels.

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setGoToPage(goToPageItem)

Hier legen Sie fest, zu welcher Seite gesprungen werden soll, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde (d. h., wenn dieser Seitenumbruch durch normale lineare Fortbewegung durch das Formular 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 – dieses PageBreakItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setGoToPage(navigationType)

Hier legen Sie fest, welche Art der Seitennavigation nach dem Ausfüllen der Seite vor diesem Seitenumbruch erfolgt (d. h., wenn dieser Seitenumbruch durch normale lineare Fortbewegung durch das Formular erreicht wird). Wenn die Seite eine MultipleChoiceItem oder ListItem mit einer Navigationsoption enthält, wird diese Navigation überschrieben.

Parameter

NameTypBeschreibung
navigationTypePageNavigationTypedie Navigationsaktion, die ausgeführt werden soll, nachdem die Seite vor diesem Seitenumbruch abgeschlossen wurde

Rückflug

PageBreakItem – dieses PageBreakItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setHelpText(text)

Hiermit wird der Hilfetext des Elements festgelegt (bei Layoutelementen wie ImageItems, PageBreakItems und SectionHeaderItems auch als Beschreibungstext bezeichnet).

Parameter

NameTypBeschreibung
textStringden neuen Hilfetext

Rückflug

PageBreakItem – dieses PageBreakItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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

setTitle(title)

Hiermit wird der Titel des Artikels festgelegt (im Fall eines SectionHeaderItem auch als Headertext bezeichnet).

Parameter

NameTypBeschreibung
titleStringden neuen Titel oder Headertext

Rückflug

PageBreakItem – dieses PageBreakItem für die Verkettung

Autorisierung

Scripts, die diese Methode verwenden, erfordern eine Autorisierung für einen oder mehrere der folgenden Bereiche:

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