Class Choice

Choix

Choix unique associé à un type de Item compatible, comme CheckboxItem, ListItem ou MultipleChoiceItem.

// Create a new form and add a multiple-choice item.
var form = FormApp.create('Form Name');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats', FormApp.PageNavigationType.CONTINUE),
        item.createChoice('Dogs', FormApp.PageNavigationType.RESTART)
    ]);

// Add another page because navigation has no effect on the last page.
form.addPageBreakItem().setTitle('You chose well!');

// Log the navigation types that each choice results in.
var choices = item.getChoices();
for (var i = 0; i < choices.length; i++) {
Logger.log('If the respondent chooses "%s", the form will %s.',
           choices[i].getValue(),
           choices[i].getPageNavigationType());
}

Méthodes

MéthodeType renvoyéBrève description
getGotoPage()PageBreakItemRécupère le PageBreakItem défini comme destination GO_TO_PAGE. si la personne interrogée sélectionne ce choix et termine la page en cours.
getPageNavigationType()PageNavigationTypeRécupère l'PageNavigationType qui se produit si la personne interrogée sélectionne ce choix et complète la page actuelle.
getValue()StringRécupère la valeur du choix, que les répondants voient sous forme d'étiquette lorsqu'ils consultent le formulaire.
isCorrectAnswer()BooleanDétermine si le choix correspond à la bonne réponse à la question.

Documentation détaillée

getGotoPage()

Récupère le PageBreakItem défini comme destination GO_TO_PAGE. si la personne interrogée sélectionne cette option et termine la page en cours. Cette méthode ne s'applique aux choix associés à MultipleChoiceItems ; pour d'autres choix, la fonction renvoie null.

Renvois

PageBreakItem : destination GO_TO_PAGE pour ce choix ou null en l'absence de destination

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

getPageNavigationType()

Récupère l'PageNavigationType qui se produit si la personne interrogée sélectionne ce choix et complète la page actuelle. Cette méthode ne s'applique qu'aux choix associés à MultipleChoiceItems. pour les autres options, il renvoie null.

Renvois

PageNavigationType : action de navigation pour ce choix ou null s'il n'y en a pas

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

getValue()

Récupère la valeur du choix, que les répondants voient sous forme d'étiquette lorsqu'ils consultent le formulaire.

Renvois

String : valeur du choix

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

isCorrectAnswer()

Détermine si le choix correspond à la bonne réponse à la question. Cette méthode ne s'applique les questions qui font partie d'un quiz ; pour les formulaires autres que des quiz, la valeur renvoyée est "false".

Renvois

Boolean : indique si le choix est une bonne réponse.

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