Class Choice

Choice

בחירה יחידה שמשויכת לסוג Item שתומך בבחירות, כמו CheckboxItem,‏ ListItem או 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(),
  );
}

Methods

שיטהסוג הערך שמוחזרתיאור קצר
getGotoPage()PageBreakItemמקבל את PageBreakItem שהוגדר כיעד GO_TO_PAGE אם המשיב בוחר באפשרות הזו ומשלים את הדף הנוכחי.
getPageNavigationType()PageNavigationTypeמחזירה את PageNavigationType שמתרחש אם המשיב בוחר באפשרות הזו ומשלים את הדף הנוכחי.
getValue()Stringמחזירה את הערך של הבחירה, שמוצג למשיבים כתווית כשהם צופים בטופס.
isCorrectAnswer()Booleanמחזירה אם הבחירה היא תשובה נכונה לשאלה.

תיעוד מפורט

getGotoPage()

מקבל את PageBreakItem שהוגדר כיעד GO_TO_PAGE אם המשיב בוחר באפשרות הזו ומשלים את הדף הנוכחי. השיטה הזו חלה רק על אפשרויות שמשויכות ל-MultipleChoiceItems. לאפשרויות אחרות היא מחזירה null.

חזרה

PageBreakItem – היעד GO_TO_PAGE של הבחירה הזו, או null אם אין יעד

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getPageNavigationType()

מחזירה את PageNavigationType שמתרחש אם המשיב בוחר באפשרות הזו ומשלים את הדף הנוכחי. השיטה הזו חלה רק על אפשרויות שמשויכות ל-MultipleChoiceItems. לאפשרויות אחרות היא מחזירה null.

חזרה

PageNavigationType – פעולת הניווט לבחירה הזו, או null אם אין פעולה כזו

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

getValue()

מחזירה את הערך של הבחירה, שמוצג למשיבים כתווית כשהם צופים בטופס.

חזרה

String – הערך של הבחירה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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

isCorrectAnswer()

מחזירה אם הבחירה היא תשובה נכונה לשאלה. השיטה הזו רלוונטית רק לשאלות שהן חלק מחידון. בטפסים שאינם חידונים, היא מחזירה False.

חזרה

Boolean — האם הבחירה היא תשובה נכונה.

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחת או יותר מההיקפים הבאים:

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