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