Class PageBreakItem

PageBreakItem

É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éthodeType renvoyéBrève description
duplicate()PageBreakItemCrée une copie de cet élément et l'ajoute à la fin du formulaire.
getGoToPage()PageBreakItemRé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()StringRé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()IntegerRécupère l'identifiant unique de l'article.
getIndex()IntegerRécupère l'index de l'élément parmi tous les éléments du formulaire.
getPageNavigationType()PageNavigationTypeRé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()StringRécupère le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem).
getType()ItemTypeRécupère le type de l'élément, représenté par ItemType.
setGoToPage(goToPageItem)PageBreakItemDé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)PageBreakItemDé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)PageBreakItemDé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)PageBreakItemDé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

getPageNavigationType()

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).

Aller-retour

PageNavigationType : action de navigation à effectuer après que l'utilisateur a rempli la page avant ce saut de page

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

NomTypeDescription
goToPageItemPageBreakItemsaut 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

setGoToPage(navigationType)

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). Si la page contenait un élément MultipleChoiceItem ou ListItem avec une option de navigation, celle-ci remplace cette navigation.

Paramètres

NomTypeDescription
navigationTypePageNavigationTypeAction de navigation à effectuer après avoir terminé de remplir la page avant ce saut de page

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

NomTypeDescription
textStringle 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

NomTypeDescription
titleStringle 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