Class Choice

Choix

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

// Create a new form and add a multiple-choice item.
const form = FormApp.create('Form Name');
const 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.
const choices = item.getChoices();
for (let 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éthode	Type renvoyé	Brève description
getGotoPage()	PageBreakItem	Obtient le PageBreakItem défini comme destination GO_TO_PAGE si la personne qui répond sélectionne ce choix et remplit la page actuelle.
getPageNavigationType()	PageNavigationType	Obtient le PageNavigationType qui se produit si la personne qui répond sélectionne ce choix et remplit la page actuelle.
getValue()	String	Obtient la valeur du choix, que les personnes qui répondent voient comme un libellé lorsqu'elles consultent le formulaire.
isCorrectAnswer()	Boolean	Indique si le choix est une réponse correcte à la question.

Documentation détaillée

getGotoPage()

Obtient le PageBreakItem défini comme destination GO_TO_PAGE si la personne qui répond sélectionne ce choix et remplit la page actuelle. Cette méthode ne s'applique qu'aux choix associés à des MultipleChoiceItems. Pour les autres choix, elle renvoie null.

Renvois

PageBreakItem : destination GO_TO_PAGE pour ce choix, ou null s'il n'y en a pas

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

---

getPageNavigationType()

Obtient le PageNavigationType qui se produit si la personne qui répond sélectionne ce choix et remplit la page actuelle. Cette méthode ne s'applique qu'aux choix associés à des MultipleChoiceItems. Pour les autres choix, elle 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 avec un ou plusieurs des champs d'application suivants :

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

---

getValue()

Obtient la valeur du choix, que les personnes qui répondent voient comme un libellé lorsqu'elles consultent le formulaire.

Renvois

String : valeur du choix

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

---

isCorrectAnswer()

Indique si le choix est une réponse correcte à la question. Cette méthode ne s'applique qu'aux questions qui font partie d'un quiz. Pour les formulaires qui ne sont pas des quiz, elle renvoie "false".

Renvois

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

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