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

Class GridItem

Un élément de question, présenté sous la forme d'une grille de colonnes et de lignes, qui permet à la personne interrogée de sélectionner une seule réponse par ligne parmi une série de cases d'option. Les éléments peuvent être consultés et créés à partir d'un Form

// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

Méthodes

Méthode	Type renvoyé	Brève description
`clearValidation()`	`GridItem`	Supprime toute validation des données pour cet élément de grille.
`createResponse(responses)`	`ItemResponse`	Crée une `ItemResponse` pour cet élément de grille.
`duplicate()`	`GridItem`	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'une `SectionHeaderItem`).
`getType()`	`ItemType`	Récupère le type d'élément, représenté par `ItemType`.
`isRequired()`	`Boolean`	Détermine si la personne interrogée doit répondre à la question.
`setColumns(columns)`	`GridItem`	Définit les colonnes de la grille en fonction d'un tableau de valeurs.
`setHelpText(text)`	`GridItem`	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)`	`GridItem`	Détermine si la personne interrogée doit répondre à la question.
`setRows(rows)`	`GridItem`	Définit les lignes de la grille en fonction d'un tableau de valeurs.
`setTitle(title)`	`GridItem`	Définit le titre de l'élément (parfois appelé "texte d'en-tête" dans le cas d'une propriété `SectionHeaderItem`).
`setValidation(validation)`	`GridItem`	Définit la validation des données pour cet élément de grille.

Documentation détaillée

`clearValidation()`

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

Renvois

GridItem : cet élément, pour l'enchaînement

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 une ItemResponse pour cet élément de grille. L'argument responses doit être une Tableau String[] contenant autant de valeurs que le nombre de lignes de la grille. Un élément null pour une question de grille non obligatoire indique qu'il n'y a pas de réponse à 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 réponses valides pour cet élément de la grille

Renvois

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

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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

GridItem : doublon de GridItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 colonnes, que les personnes interrogées voient sous forme d'étiquettes lorsqu'elles consultent le formulaire

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 description de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 correspondant à 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 d'étiquettes lorsqu'elles consultent le formulaire

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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'une 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 correspondant à 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 d'élément, représenté par ItemType.

Renvois

ItemType : type de l'élément

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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.

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 correspondant à 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. La fonction renvoie une exception si la valeur est vide.

Paramètres

Nom	Type	Description
`columns`	`String[]`	Un tableau de valeurs de colonnes, que les répondants voient sous forme d'étiquettes lorsqu'ils consultent le formulaire

Renvois

GridItem : cet élément, pour l'enchaînement

Génère

Error : si le tableau donné est null ou vide

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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

GridItem : GridItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

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

`setRequired(enabled)`

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 ;

Renvois

GridItem : élément actuel (pour l'enchaînement)

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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 d'étiquettes lorsqu'elles consultent le formulaire

Renvois

GridItem : cet élément, pour l'enchaînement

Génère

Error : si le tableau donné est null ou vide

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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'une propriété SectionHeaderItem).

Paramètres

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

Renvois

GridItem : GridItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à 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. La transmission d'une valeur nulle ou d'une validation sans aucune nécessiter des fonctions appelées supprimera toute validation antérieure.

Paramètres

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

Renvois

GridItem : GridItem, pour le chaînage

Autorisation

Les scripts qui utilisent cette méthode nécessitent une autorisation correspondant à un ou plusieurs des champs d'application suivants:

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