Class Choice

אפשרות

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

שיטות

שיטהסוג הערך המוחזרתיאור קצר
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