Class Choice

Choice

A single choice associated with a type of Item that supports choices, like CheckboxItem, ListItem, or 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());
 }
 

Methods

MethodReturn typeBrief description
getGotoPage()PageBreakItemGets the PageBreakItem set as a GO_TO_PAGE destination if the responder selects this choice and completes the current page.
getPageNavigationType()PageNavigationTypeGets the PageNavigationType that occurs if the responder selects this choice and completes the current page.
getValue()StringGets the choice's value, which respondents see as a label when viewing the form.
isCorrectAnswer()BooleanGets whether the choice is a correct answer for the question.

Detailed documentation

getGotoPage()

Gets the PageBreakItem set as a GO_TO_PAGE destination if the responder selects this choice and completes the current page. This method applies only to choices associated with MultipleChoiceItems; for other choices, it returns null.

Return

PageBreakItem — the GO_TO_PAGE destination for this choice, or null if there is none


getPageNavigationType()

Gets the PageNavigationType that occurs if the responder selects this choice and completes the current page. This method applies only to choices associated with MultipleChoiceItems; for other choices, it returns null.

Return

PageNavigationType — the navigation action for this choice, or null if there is none


getValue()

Gets the choice's value, which respondents see as a label when viewing the form.

Return

String — the choice's value


isCorrectAnswer()

Gets whether the choice is a correct answer for the question. This method only applies to questions that are part of a quiz; for non-quiz forms, it returns false.

Return

Boolean — Whether the choice is a correct answer.

Send feedback about...

Apps Script
Apps Script