Élément de question, présenté sous forme de grille de colonnes et de lignes, qui permet à la personne interrogée de sélectionner plusieurs choix par ligne parmi une séquence de cases à cocher. Vous pouvez accéder aux éléments ou les créer depuis un Form.
// Open a form by ID and add a new checkgox grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
.setRows(['New York', 'San Francisco', 'London'])
.setColumns(['2014', '2015', '2016', '2017']);
Méthodes
| Méthode | Type renvoyé | Brève description |
|---|---|---|
clearValidation() | CheckboxGridItem | Supprime la validation des données pour cet élément de la grille. |
createResponse(responses) | ItemResponse | Crée un ItemResponse pour cet élément de grille de case à cocher. |
duplicate() | CheckboxGridItem | Crée une copie de cet élément et l'ajoute à la fin du formulaire. |
getColumns() | String[] | Récupère les valeurs de chaque colonne de la grille. |
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. |
getRows() | String[] | Récupère les valeurs de chaque ligne de la grille. |
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. |
isRequired() | Boolean | Détermine si la personne interrogée doit répondre à la question. |
setColumns(columns) | CheckboxGridItem | Définit les colonnes de la grille en fonction d'un tableau de valeurs. |
setHelpText(text) | CheckboxGridItem | 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). |
setRequired(enabled) | CheckboxGridItem | Ce paramètre détermine si la personne interrogée doit répondre à la question. |
setRows(rows) | CheckboxGridItem | Définit les lignes de la grille en fonction d'un tableau de valeurs. |
setTitle(title) | CheckboxGridItem | 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) | CheckboxGridItem | Définit la validation des données pour cet élément de la case à cocher. |
Documentation détaillée
clearValidation()
Supprime la validation des données pour cet élément de la grille.
Aller-retour
CheckboxGridItem : cet élément, 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
createResponse(responses)
Crée un ItemResponse pour cet élément de grille de case à cocher. L'argument responses doit être un tableau String[][] de tableaux contenant autant de valeurs que d'entrées dans la grille de cases à cocher. Un élément null pour une question de grille non cochée indique qu'il n'y a aucune réponse à cette ligne. Lève une exception si l'une des valeurs ne correspond pas à un choix valide.
Paramètres
| Nom | Type | Description |
|---|---|---|
responses | String[][] | Tableau de réponses valides pour cet élément de grille de case à cocher |
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
CheckboxGridItem : doublon de CheckboxGridItem, 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
getColumns()
Récupère les valeurs de chaque colonne de la grille.
Aller-retour
String[] : tableau de valeurs de colonne que les personnes interrogées voient sous forme de libellés lorsqu'elles consultent le formulaire
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
getRows()
Récupère les valeurs de chaque ligne de la grille.
Aller-retour
String[] : tableau de valeurs de ligne que les personnes interrogées voient sous forme de libellés lorsqu'elles consultent le formulaire
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
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
setColumns(columns)
Définit les colonnes de la grille en fonction d'un tableau de valeurs. Lève une exception si le tableau donné est vide.
Paramètres
| Nom | Type | Description |
|---|---|---|
columns | String[] | un tableau de valeurs de colonne, que les personnes interrogées voient sous forme de libellés lorsqu'elles consultent le formulaire |
Aller-retour
CheckboxGridItem : cet élément, pour le chaînage
Génère
Error : si le tableau donné est null ou vide
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
CheckboxGridItem : cet élément CheckboxGridItem, 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
CheckboxGridItem : é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
setRows(rows)
Définit les lignes de la grille en fonction d'un tableau de valeurs. Lève une exception si le tableau donné est vide.
Paramètres
| Nom | Type | Description |
|---|---|---|
rows | String[] | Tableau de valeurs de lignes, que les personnes interrogées voient sous forme de libellés lorsqu'elles consultent le formulaire |
Aller-retour
CheckboxGridItem : cet élément, pour le chaînage
Génère
Error : si le tableau donné est null ou vide
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
CheckboxGridItem : cet élément CheckboxGridItem, 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 la case à cocher. Si vous transmettez "null" ou une validation sans aucune fonction requise appelée, toute validation antérieure sera supprimée.
Paramètres
| Nom | Type | Description |
|---|---|---|
validation | CheckboxGridValidation | une case à cocher CheckboxGridValidation à appliquer à cet élément. |
Aller-retour
CheckboxGridItem : cet élément CheckboxGridItem, 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