Cette page a été traduite par l'API Cloud Translation.

Class CheckboxGridItem

Élément de question présenté sous forme de grille de colonnes et de lignes, qui permet au répondant de sélectionner plusieurs choix par ligne parmi une séquence de cases à cocher. Vous pouvez accéder aux éléments ou en créer à partir d'un Form.

// Open a form by ID and add a new checkbox grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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 toute validation de données pour cet élément de 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'élément.
`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 `SectionHeaderItem`).
`getType()`	`ItemType`	Récupère le type de l'élément, représenté par un `ItemType`.
`isRequired()`	`Boolean`	Indique 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`	Indique 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 `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxGridItem`	Définit la validation des données pour cet élément de grille de case à cocher.

Documentation détaillée

`clearValidation()`

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

Renvois

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 de tableaux String[][] contenant autant de valeurs que le nombre d'entrées dans la grille de cases à cocher. Un élément null pour une question de type grille de cases à cocher facultative indique qu'aucune réponse n'a été fournie pour cette ligne. Génère une exception si l'une des valeurs ne correspond pas à un choix valide.

Paramètres

Nom	Type	Description
`responses`	`String[][]`	un tableau de tableaux de réponses valides pour cet élément de grille de cases à cocher

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

Renvois

CheckboxGridItem : double de 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

`getColumns()`

Récupère les valeurs de chaque colonne de la grille.

Renvois

String[] : tableau de valeurs de colonne, que les personnes interrogées voient comme des 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).

Renvois

String : texte d'aide ou 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()`

Récupère 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 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.

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

`getRows()`

Récupère les valeurs de chaque ligne de la grille.

Renvois

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 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()`

Récupère le type de l'élément, représenté par 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

`isRequired()`

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

Renvois

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. Génère 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 comme des libellés lorsqu'elles consultent le formulaire ;

Renvois

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 ;

Renvois

CheckboxGridItem : 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)`

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

CheckboxGridItem : é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 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. Génère une exception si le tableau donné est vide.

Paramètres

Nom	Type	Description
`rows`	`String[]`	un tableau de valeurs de ligne, que les personnes interrogées voient sous forme de libellés lorsqu'elles consultent le formulaire ;

Renvois

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

Paramètres

Nom	Type	Description
`title`	`String`	le nouveau titre ou le nouveau texte de l'en-tête ;

Renvois

CheckboxGridItem : 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 grille de case à cocher. Si vous transmettez une valeur nulle ou une validation sans aucune fonction require appelée, toute validation précédente sera supprimée.

Paramètres

Nom	Type	Description
`validation`	`CheckboxGridValidation`	une CheckboxGridValidation à appliquer à cet élément.

Renvois

CheckboxGridItem : 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