Un elemento del layout che contrassegna l'inizio di una pagina. È possibile accedere agli elementi o crearli da un Form.
// 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
Metodi
| Metodo | Tipo restituito | Breve descrizione |
|---|---|---|
duplicate() | PageBreakItem | Crea una copia di questo elemento e la aggiunge alla fine del modulo. |
getGoToPage() | PageBreakItem | Recupera il PageBreakItem a cui passerà il modulo dopo aver completato la pagina prima di questa interruzione di pagina (ossia, al raggiungimento di questa interruzione di pagina in normale avanzamento lineare nel modulo). |
getHelpText() | String | Recupera il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems). |
getId() | Integer | Consente di acquisire l'identificatore univoco dell'elemento. |
getIndex() | Integer | Restituisce l'indice dell'elemento tra tutti gli elementi nel modulo. |
getPageNavigationType() | PageNavigationType | Restituisce il tipo di navigazione nelle pagine che si verifica dopo aver completato la pagina prima di questa interruzione di pagina, ovvero al raggiungimento di questa interruzione di pagina in avanzamento lineare normale nel modulo. |
getTitle() | String | Consente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem). |
getType() | ItemType | Restituisce il tipo di elemento, rappresentato come ItemType. |
setGoToPage(goToPageItem) | PageBreakItem | Imposta la pagina a cui saltare dopo il completamento della pagina prima di questa interruzione di pagina (ossia al raggiungimento di questa interruzione di pagina in normale avanzamento lineare nel modulo). |
setGoToPage(navigationType) | PageBreakItem | Imposta il tipo di navigazione nelle pagine che si verifica dopo aver completato la pagina prima di questa interruzione di pagina, ovvero al raggiungimento di questa interruzione di pagina in avanzamento lineare normale nel modulo. |
setHelpText(text) | PageBreakItem | Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems). |
setTitle(title) | PageBreakItem | Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem). |
Documentazione dettagliata
duplicate()
Crea una copia di questo elemento e la aggiunge alla fine del modulo.
Ritorni
PageBreakItem: duplicato di questo PageBreakItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getGoToPage()
Recupera il PageBreakItem a cui passerà il modulo dopo aver completato la pagina prima di questa interruzione di pagina (ossia, al raggiungimento di questa interruzione di pagina in normale avanzamento lineare nel modulo).
Ritorni
PageBreakItem: l'interruzione di pagina a cui saltare dopo aver completato la pagina prima di questa interruzione di pagina o null se non ne è impostata nessuna
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getHelpText()
Recupera il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
Ritorni
String: testo della guida o testo descrittivo dell'elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getId()
Consente di acquisire l'identificatore univoco dell'elemento.
Ritorni
Integer: ID dell'articolo
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getIndex()
Restituisce l'indice dell'elemento tra tutti gli elementi nel modulo.
Ritorni
Integer: l'indice dell'elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getTitle()
Consente di acquisire il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).
Ritorni
String: testo dell'intestazione o del titolo dell'elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
getType()
Restituisce il tipo di elemento, rappresentato come ItemType.
Ritorni
ItemType: tipo di elemento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setGoToPage(goToPageItem)
Imposta la pagina a cui saltare dopo il completamento della pagina prima di questa interruzione di pagina (ossia al raggiungimento di questa interruzione di pagina in normale avanzamento lineare nel modulo). Se la pagina precedente
conteneva un elemento MultipleChoiceItem o ListItem con un'opzione di navigazione, questa
navigazione prevale su questa navigazione.
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
goToPageItem | PageBreakItem | l'interruzione di pagina a cui saltare dopo aver completato la pagina prima di questa interruzione di pagina |
Ritorni
PageBreakItem: questo PageBreakItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setHelpText(text)
Imposta il testo della guida dell'elemento (a volte chiamato testo descrittivo per elementi di layout come ImageItems, PageBreakItems e SectionHeaderItems).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
text | String | il nuovo testo della guida |
Ritorni
PageBreakItem: questo PageBreakItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms
setTitle(title)
Imposta il titolo dell'elemento (a volte chiamato testo dell'intestazione, nel caso di SectionHeaderItem).
Parametri
| Nome | Tipo | Descrizione |
|---|---|---|
title | String | il nuovo testo dell'intestazione o del titolo |
Ritorni
PageBreakItem: questo PageBreakItem, per il concatenamento
Autorizzazione
Gli script che utilizzano questo metodo richiedono l'autorizzazione con uno o più dei seguenti ambiti:
-
https://www.googleapis.com/auth/forms.currentonly -
https://www.googleapis.com/auth/forms