Élément de mise en page qui marque le début d'une page. Vous pouvez accéder aux éléments ou les créer depuis 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
Méthodes
Méthode | Type renvoyé | Brève description |
---|---|---|
duplicate() | PageBreakItem | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
getGoToPage() | PageBreakItem | Récupère le PageBreakItem auquel le formulaire accédera une fois la page terminée avant ce saut de page (c'est-à-dire lorsqu'il atteint ce saut de page par une progression linéaire normale via le formulaire). |
getHelpText() | String | Récupère le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems , PageBreakItems et SectionHeaderItems ). |
getId() | Integer | Récupère l'identifiant unique de l'article. |
getIndex() | Integer | Récupère l'index de l'élément parmi tous les éléments du formulaire. |
getPageNavigationType() | PageNavigationType | Récupère le type de navigation sur la page une fois qu'il est terminé avant d'avoir inséré ce saut de page (autrement dit, lorsqu'il atteint ce saut de page par la progression linéaire normale via le formulaire). |
getTitle() | String | Récupère le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem ). |
getType() | ItemType | Récupère le type de l'élément, représenté par ItemType . |
setGoToPage(goToPageItem) | PageBreakItem | Définit la page de sorte qu'elle passe directement après le saut de page, c'est-à-dire lorsqu'elle atteint ce saut de page par la progression linéaire normale via le formulaire. |
setGoToPage(navigationType) | PageBreakItem | Définit le type de navigation sur la page qui s'effectue après que celle-ci a été enregistrée avant un saut de page (soit lorsqu'elle atteint ce saut de page par une progression linéaire normale via le formulaire). |
setHelpText(text) | PageBreakItem | Définit le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems , PageBreakItems et SectionHeaderItems ). |
setTitle(title) | PageBreakItem | Définit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem ). |
Documentation détaillée
duplicate()
Crée une copie de cet élément et l'ajoute à la fin du formulaire.
Aller-retour
PageBreakItem
: doublon de PageBreakItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGoToPage()
Récupère le PageBreakItem
auquel le formulaire accédera une fois la page terminée avant ce saut de page (c'est-à-dire lorsqu'il atteint ce saut de page par une progression linéaire normale via le formulaire).
Aller-retour
PageBreakItem
: saut de page auquel accéder après la fin de la page, ou null
si aucun n'est défini
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getHelpText()
Récupère le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems
, PageBreakItems
et SectionHeaderItems
).
Aller-retour
String
: texte d'aide ou description
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getId()
Récupère l'identifiant unique de l'article.
Aller-retour
Integer
: ID de l'article
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getIndex()
Récupère l'index de l'élément parmi tous les éléments du formulaire.
Aller-retour
Integer
: index de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getTitle()
Récupère le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem
).
Aller-retour
String
: titre ou texte de l'en-tête de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
Récupère le type de l'élément, représenté par ItemType
.
Aller-retour
ItemType
: type de l'élément
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setGoToPage(goToPageItem)
Définit la page de sorte qu'elle passe directement après le saut de page, c'est-à-dire lorsqu'elle atteint ce saut de page par la progression linéaire normale via le formulaire. Si la page précédente contenait un MultipleChoiceItem
ou un ListItem
avec une option de navigation, celle-ci remplace cette navigation.
Paramètres
Nom | Type | Description |
---|---|---|
goToPageItem | PageBreakItem | saut de page vers lequel accéder une fois la page terminée |
Aller-retour
PageBreakItem
: cet élément PageBreakItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
Définit le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que ImageItems
, PageBreakItems
et SectionHeaderItems
).
Paramètres
Nom | Type | Description |
---|---|---|
text | String | le nouveau texte d'aide |
Aller-retour
PageBreakItem
: cet élément PageBreakItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
Définit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem
).
Paramètres
Nom | Type | Description |
---|---|---|
title | String | le nouveau titre ou texte de l'en-tête |
Aller-retour
PageBreakItem
: cet élément PageBreakItem
, pour le chaînage
Autorisation
Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des champs d'application suivants :
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms