Élément de question qui permet à la personne interrogée de sélectionner une ou plusieurs cases, ainsi qu'un champ facultatif de type "Autre". Vous pouvez accéder aux éléments ou les créer depuis un Form. Lorsqu'ils sont utilisés dans un questionnaire, ces éléments sont notés automatiquement.
// Open a form by ID and add a new checkbox item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
.setChoices([
item.createChoice('Ketchup'),
item.createChoice('Mustard'),
item.createChoice('Relish')
])
.showOtherOption(true);
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
clearValidation() | CheckboxItem | Supprime la validation des données pour cet élément de case à cocher. |
createChoice(value) | Choice | Crée un choix. |
createChoice(value, isCorrect) | Choice | Crée un choix. |
createResponse(responses) | ItemResponse | Crée un ItemResponse pour cet élément de case à cocher. |
duplicate() | CheckboxItem | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
getChoices() | Choice[] | Récupère tous les choix possibles pour un élément. |
getFeedbackForCorrect() | QuizFeedback | Affiche les commentaires fournis aux personnes interrogées lorsqu'elles répondent correctement à une question. |
getFeedbackForIncorrect() | QuizFeedback | Affiche les commentaires fournis aux personnes interrogées lorsqu'elles répondent mal à une question. |
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. |
getPoints() | Integer | Affiche le barème de notation d'un élément. |
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. |
hasOtherOption() | Boolean | Détermine si l'article est associé à une option "Autre". |
isRequired() | Boolean | Détermine si la personne interrogée doit répondre à la question. |
setChoiceValues(values) | CheckboxItem | Définit les choix d'un élément à partir d'un tableau de chaînes. |
setChoices(choices) | CheckboxItem | Définit un tableau de choix pour un élément. |
setFeedbackForCorrect(feedback) | CheckboxItem | Définit les commentaires à afficher aux personnes interrogées lorsqu'elles répondent correctement à une question. |
setFeedbackForIncorrect(feedback) | CheckboxItem | Définit les commentaires à afficher aux personnes interrogées lorsqu'elles répondent mal à une question. |
setHelpText(text) | CheckboxItem | 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) | CheckboxItem | Définit le nombre de points qu'un élément notable vaut. |
setRequired(enabled) | CheckboxItem | Ce paramètre détermine si la personne interrogée doit répondre à la question. |
setTitle(title) | CheckboxItem | Définit le titre de l'élément (parfois appelé texte d'en-tête, dans le cas d'un élément SectionHeaderItem). |
setValidation(validation) | CheckboxItem | Définit la validation des données pour cet élément de case à cocher. |
showOtherOption(enabled) | CheckboxItem | Détermine si l'élément comporte une option "Autre". |
Documentation détaillée
clearValidation()
Supprime la validation des données pour cet élément de case à cocher.
Aller-retour
CheckboxItem : cet élément CheckboxItem, 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
createChoice(value)
Crée un choix.
Paramètres
| Nom | Type | Description |
|---|---|---|
value | String | Valeur du choix que les personnes interrogées voient sous forme de libellé lorsqu'elles consultent le formulaire |
Aller-retour
Choice : nouveau choix
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
createChoice(value, isCorrect)
Crée un choix.
Paramètres
| Nom | Type | Description |
|---|---|---|
value | String | Valeur du choix que les personnes interrogées voient sous forme de libellé lorsqu'elles consultent le formulaire |
isCorrect | Boolean | si la réponse est la bonne réponse |
Aller-retour
Choice : nouveau choix
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
createResponse(responses)
Crée un ItemResponse pour cet élément de case à cocher. L'argument responses est un tableau String[] contenant les valeurs à vérifier. Lève une exception si une valeur ne correspond pas à un choix valide pour cet élément, sauf si showOtherOption(enabled) est défini sur true.
Paramètres
| Nom | Type | Description |
|---|---|---|
responses | String[] | Tableau des réponses valides pour cet élément à choix multiples |
Aller-retour
ItemResponse : réponse 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
duplicate()
Crée une copie de cet élément et l'ajoute à la fin du formulaire.
Aller-retour
CheckboxItem : doublon de CheckboxItem, 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
getChoices()
Récupère tous les choix possibles pour un élément.
Aller-retour
Choice[] : un tableau de choix
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
getFeedbackForCorrect()
Affiche les commentaires fournis aux personnes interrogées lorsqu'elles répondent correctement à une question.
Aller-retour
QuizFeedback : commentaires, le cas échéant.
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
getFeedbackForIncorrect()
Affiche les commentaires fournis aux personnes interrogées lorsqu'elles répondent mal à une question.
Aller-retour
QuizFeedback : commentaires, le cas échéant.
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
getPoints()
Affiche le barème de notation d'un élément.
Aller-retour
Integer : nombre de points gagnés par une question.
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
hasOtherOption()
Détermine si l'article est associé à une option "Autre".
Aller-retour
Boolean : true si l'article est associé à une option "other" (false) dans le cas contraire
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
isRequired()
Détermine si la personne interrogée doit répondre à la question.
Aller-retour
Boolean : indique si la personne interrogée doit répondre à la question.
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
setChoiceValues(values)
Définit les choix d'un élément à partir d'un tableau de chaînes. Lève une exception si le tableau donné est vide.
// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);
Paramètres
| Nom | Type | Description |
|---|---|---|
values | String[] | Tableau des valeurs de choix que les personnes interrogées voient sous forme de libellés lorsqu'elles consultent le formulaire |
Aller-retour
CheckboxItem : cet élément CheckboxItem, 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
setChoices(choices)
Définit un tableau de choix pour un élément. Lève une exception si le tableau donné est vide ou contient un élément null.
// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
item.createChoice('Cats'),
item.createChoice('Dogs')
]);
Paramètres
| Nom | Type | Description |
|---|---|---|
choices | Choice[] | un large éventail de choix |
Aller-retour
CheckboxItem : cet élément CheckboxItem, pour le chaînage
Génère
Error : si le tableau donné est null, vide ou contient un élément null
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
setFeedbackForCorrect(feedback)
Définit les commentaires à afficher aux personnes interrogées lorsqu'elles répondent correctement à une question.
// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
item.createChoice('Dogs', true),
item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());
Paramètres
| Nom | Type | Description |
|---|---|---|
feedback | QuizFeedback | les nouveaux commentaires. Une valeur nulle efface le commentaire. |
Aller-retour
CheckboxItem : cet élément CheckboxItem, 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
setFeedbackForIncorrect(feedback)
Définit les commentaires à afficher aux personnes interrogées lorsqu'elles répondent mal à une question.
Paramètres
| Nom | Type | Description |
|---|---|---|
feedback | QuizFeedback | les nouveaux commentaires |
Aller-retour
CheckboxItem : cet élément CheckboxItem, 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
CheckboxItem : cet élément CheckboxItem, 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
setPoints(points)
Définit le nombre de points qu'un élément notable vaut. La valeur par défaut pour les nouveaux éléments est 0.
Paramètres
| Nom | Type | Description |
|---|---|---|
points | Integer | le nombre de points d'une question |
Aller-retour
CheckboxItem : cet élément CheckboxItem, 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
setRequired(enabled)
Ce paramètre détermine 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 |
Aller-retour
CheckboxItem : élément actuel (pour les chaînages)
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
CheckboxItem : cet élément CheckboxItem, 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
setValidation(validation)
Définit la validation des données pour cet élément de case à cocher. La transmission de la valeur "null" ou d'une validation sans aucune fonction requise appelée supprimera toute validation antérieure.
Paramètres
| Nom | Type | Description |
|---|---|---|
validation | CheckboxValidation | une case à cocher "CheckboxValidation" à appliquer à cet article. |
Aller-retour
CheckboxItem : cet élément CheckboxItem, 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
showOtherOption(enabled)
Détermine si l'élément comporte une option "Autre". La valeur par défaut pour un nouveau CheckboxItem ou MultipleChoiceItem est false.
Paramètres
| Nom | Type | Description |
|---|---|---|
enabled | Boolean | true si l'article est associé à une option "other" (false) dans le cas contraire. |
Aller-retour
CheckboxItem : cet élément CheckboxItem, 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