Class ParagraphTextItem

ParagraphTextItem

Élément de question qui permet au répondant de saisir un bloc de texte. Les éléments sont accessibles ou peuvent être créés à partir d'un Form. Lorsqu'ils sont utilisés dans un quiz, ces éléments sont notés.

// Open a form by ID and add a new paragraph text item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addParagraphTextItem();
item.setTitle('What is your address?');

Méthodes

Méthode	Type renvoyé	Brève description
clearValidation()	ParagraphTextItem	Supprime toute validation de données pour cet élément de texte de paragraphe.
createResponse(response)	ItemResponse	Crée un ItemResponse pour cet élément de texte de paragraphe.
duplicate()	ParagraphTextItem	Crée une copie de cet élément et l'ajoute à la fin du formulaire.
getGeneralFeedback()	QuizFeedback|null	Renvoie les commentaires affichés aux participants lorsqu'ils répondent à une question pouvant être notée.
getHelpText()	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 ImageItems, PageBreakItems et SectionHeaderItems).
getId()	Integer	Obtient l'identifiant unique de l'élément.
getIndex()	Integer	Obtient l'index de l'élément parmi tous les éléments du formulaire.
getPoints()	Integer	Renvoie la valeur en points d'un élément pouvant être noté.
getTitle()	String	Obtient le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un SectionHeaderItem).
getType()	ItemType	Obtient le type de l'élément, représenté sous la forme d'un ItemType.
isRequired()	Boolean	Détermine si la personne interrogée doit répondre à la question.
setGeneralFeedback(feedback)	ParagraphTextItem	Définit le commentaire à afficher aux participants lorsqu'ils répondent à une question évaluable qui n'a pas de réponse correcte ou incorrecte (c'est-à-dire les questions qui nécessitent une évaluation manuelle).
setHelpText(text)	ParagraphTextItem	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).
setPoints(points)	ParagraphTextItem	Définit le nombre de points qu'un devoir peut rapporter.
setRequired(enabled)	ParagraphTextItem	Indique si la personne interrogée doit répondre à la question.
setTitle(title)	ParagraphTextItem	Définit le titre de l'élément (parfois appelé texte d'en-tête dans le cas d'un SectionHeaderItem).
setValidation(validation)	ParagraphTextItem	Définit la validation des données pour cet élément de texte de paragraphe.

Documentation détaillée

clearValidation()

Supprime toute validation de données pour cet élément de texte de paragraphe.

Renvois

ParagraphTextItem : ParagraphTextItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

createResponse(response)

Crée un ItemResponse pour cet élément de texte de paragraphe.

Paramètres

Nom	Type	Description
response	String	une réponse à la question posée par l'élément ;

Renvois

ItemResponse : réponse de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

duplicate()

Crée une copie de cet élément et l'ajoute à la fin du formulaire.

Renvois

ParagraphTextItem : un double de ce ParagraphTextItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

getGeneralFeedback()

Renvoie les commentaires affichés aux participants lorsqu'ils répondent à une question pouvant être notée.

Renvois

QuizFeedback|null : commentaire, le cas échéant.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 description de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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'article

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 scopes suivants :

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

---

getPoints()

Renvoie la valeur en points d'un élément pouvant être noté.

Renvois

Integer : nombre de points attribués à une question.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 scopes 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 scopes suivants :

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

---

isRequired()

Détermine si la personne interrogée doit répondre à la question.

Renvois

Boolean : indique si le répondant doit répondre à la question.

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

setGeneralFeedback(feedback)

Définit le commentaire à afficher aux participants lorsqu'ils répondent à une question évaluable qui n'a pas de réponse correcte ou incorrecte (c'est-à-dire les questions qui nécessitent une évaluation manuelle).

Paramètres

Nom	Type	Description
feedback	QuizFeedback	les nouveaux commentaires

Renvois

ParagraphTextItem : ParagraphTextItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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 ;

Renvois

ParagraphTextItem : ParagraphTextItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

setPoints(points)

Définit le nombre de points qu'un devoir peut rapporter. La valeur par défaut pour les nouveaux éléments est 0.

Paramètres

Nom	Type	Description
points	Integer	le nombre de points qu'un élément de question vaut ;

Renvois

ParagraphTextItem : ParagraphTextItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

setRequired(enabled)

Indique si la personne interrogée doit répondre à la question.

Paramètres

Nom	Type	Description
enabled	Boolean	si la personne interrogée doit répondre à la question.

Renvois

ParagraphTextItem : élément actuel (pour l'association en chaîne)

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes 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	le nouveau titre ou texte d'en-tête.

Renvois

ParagraphTextItem : ParagraphTextItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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

---

setValidation(validation)

Définit la validation des données pour cet élément de texte de paragraphe. Si vous transmettez null ou une instance ParagraphTextValidation sur laquelle aucune fonction require n'a été appelée, toute validation antérieure est supprimée.

Paramètres

Nom	Type	Description
validation	ParagraphTextValidation	un objet ParagraphTextValidation à appliquer à cet élément.

Renvois

ParagraphTextItem : ParagraphTextItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation avec un ou plusieurs des scopes suivants :

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