Élément de mise en page qui indique visuellement le début d'une section. Vous pouvez accéder à des éléments ou en créer à partir d'un Form.
// Open a form by ID and add a new section header. const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); const item = form.addSectionHeaderItem(); item.setTitle('Title of new section');
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
duplicate() | Section | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
get | String | Obtient le texte d'aide de l'élément (parfois appelé texte de description pour les éléments de mise en page tels que Image, Page, et Section). |
get | Integer | Obtient l'identifiant unique de l'élément. |
get | Integer | Obtient l'index de l'élément parmi tous les éléments du formulaire. |
get | String | Obtient le titre de l'élément (parfois appelé texte d'en-tête dans le cas d'un Section). |
get | Item | Obtient le type de l'élément, représenté sous la forme d'un Item. |
set | Section | 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 Image, Page, et Section). |
set | Section | Définit le titre de l'élément (parfois appelé texte d'en-tête dans le cas d'un Section). |
Documentation détaillée
duplicate()
Crée une copie de cet élément et l'ajoute à la fin du formulaire.
Renvois
SectionHeaderItem : un doublon de ce SectionHeaderItem, 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
getHelpText()
Obtient 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).
Renvois
String : texte d'aide ou texte de description 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
getId()
Obtient l'identifiant unique de l'élément.
Renvois
Integer : ID 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
getIndex()
Obtient l'index de l'élément parmi tous les éléments du formulaire.
Renvois
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()
Obtient le titre de l'élément (parfois appelé texte d'en-tête dans le cas d'un SectionHeaderItem).
Renvois
String : titre ou texte d'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()
Obtient le type de l'élément, représenté sous la forme d'un ItemType.
Renvois
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
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 | nouveau texte d'aide |
Renvois
SectionHeaderItem : ce SectionHeaderItem, 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 SectionHeaderItem).
Paramètres
| Nom | Type | Description |
|---|---|---|
title | String | nouveau titre ou texte d'en-tête |
Renvois
SectionHeaderItem : ce SectionHeaderItem, 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