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

Class ScaleItem

Élément de question permettant au répondant de choisir une option parmi une séquence numérotée de cases d'option. Vous pouvez accéder aux éléments ou en créer à 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 scale item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10').setBounds(1, 10);

Méthodes

Méthode	Type renvoyé	Brève description
`createResponse(response)`	`ItemResponse`	Crée un `ItemResponse` pour cet élément de l'échelle.
`duplicate()`	`ScaleItem`	Crée une copie de cet élément et l'ajoute à la fin du formulaire.
`getGeneralFeedback()`	`QuizFeedback`	Renvoie les commentaires qui s'affichent auprès des personnes interrogées lorsqu'elles répondent à une question notée.
`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'indice de l'élément parmi tous les éléments du formulaire.
`getLeftLabel()`	`String`	Récupère le libellé de la limite inférieure de l'échelle, le cas échéant.
`getLowerBound()`	`Integer`	Récupère la limite inférieure de l'échelle.
`getPoints()`	`Integer`	Renvoie la valeur en points d'un élément évaluable.
`getRightLabel()`	`String`	Récupère le libellé de la limite supérieure de l'échelle, le cas échéant.
`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`.
`getUpperBound()`	`Integer`	Récupère la limite supérieure de la balance.
`isRequired()`	`Boolean`	Indique si la personne interrogée doit répondre à la question.
`setBounds(lower, upper)`	`ScaleItem`	Définit les limites inférieure et supérieure de l'échelle.
`setGeneralFeedback(feedback)`	`ScaleItem`	Définit les commentaires à afficher aux personnes interrogées lorsqu'elles répondent à une question évaluable qui n'a pas de bonne ni de mauvaise réponse (c'est-à-dire des questions qui nécessitent une notation manuelle).
`setHelpText(text)`	`ScaleItem`	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`).
`setLabels(lower, upper)`	`ScaleItem`	Définit les libellés des limites inférieure et supérieure de l'échelle.
`setPoints(points)`	`ScaleItem`	Définit le nombre de points d'un élément évaluable.
`setRequired(enabled)`	`ScaleItem`	Indique si la personne interrogée doit répondre à la question.
`setTitle(title)`	`ScaleItem`	Définit le titre de l'élément (parfois appelé "texte d'en-tête", dans le cas d'un `SectionHeaderItem`).

Documentation détaillée

`createResponse(response)`

Crée un ItemResponse pour cet élément de l'échelle. Génère une exception si l'argument response se trouve en dehors des limites définies pour l'élément.

Paramètres

Nom	Type	Description
`response`	`Integer`	une réponse de valeur pour cet élément d'échelle ;

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

ScaleItem : double de cet élément ScaleItem, 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

`getGeneralFeedback()`

Renvoie les commentaires qui s'affichent auprès des personnes interrogées lorsqu'elles répondent à une question notée.

Renvois

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

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'indice 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

`getLeftLabel()`

Récupère le libellé de la limite inférieure de l'échelle, le cas échéant.

Renvois

String : libellé de la limite inférieure de l'échelle

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

`getLowerBound()`

Récupère la limite inférieure de l'échelle.

Renvois

Integer : limite inférieure de l'échelle

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

Renvoie la valeur en points d'un élément évaluable.

Renvois

Integer : nombre de points qu'une question rapporte.

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

`getRightLabel()`

Récupère le libellé de la limite supérieure de l'échelle, le cas échéant.

Renvois

String : libellé de la limite supérieure de l'échelle

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

`getUpperBound()`

Récupère la limite supérieure de la balance.

Renvois

Integer : limite supérieure de l'échelle

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

`setBounds(lower, upper)`

Définit les limites inférieure et supérieure de l'échelle. La limite inférieure doit être 0 ou 1. La borne supérieure doit être comprise entre 3 et 10 inclus. Une nouvelle échelle est définie par défaut sur une limite inférieure de 1 et une limite supérieure de 5.

Génère une exception de script si les valeurs données dépassent les limites autorisées. Les décimales sont tronquées à l'entier précédent.

Paramètres

Nom	Type	Description
`lower`	`Integer`	la nouvelle limite inférieure ;
`upper`	`Integer`	la nouvelle limite supérieure

Renvois

ScaleItem : ScaleItem, pour le chaînage

Génère

Error : si la limite inférieure ou supérieure n'est pas valide

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

`setGeneralFeedback(feedback)`

Définit les commentaires à afficher aux personnes interrogées lorsqu'elles répondent à une question évaluable qui n'a pas de bonne ni de mauvaise réponse (c'est-à-dire des questions qui nécessitent une notation manuelle).

Paramètres

Nom	Type	Description
`feedback`	`QuizFeedback`	les nouveaux commentaires

Renvois

ScaleItem : ScaleItem, 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 ;

Renvois

ScaleItem : ScaleItem, 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

`setLabels(lower, upper)`

Définit les libellés des limites inférieure et supérieure de l'échelle.

Paramètres

Nom	Type	Description
`lower`	`String`	nouveau libellé de la borne inférieure
`upper`	`String`	nouveau libellé de la limite supérieure

Renvois

ScaleItem : ScaleItem, 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 d'un élément évaluable. 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

ScaleItem : ScaleItem, 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

ScaleItem : é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

`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

ScaleItem : ScaleItem, 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