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()

لمعرفة ما إذا كان الخيار هو إجابة صحيحة عن السؤال. لا تنطبق هذه الطريقة إلا على الأسئلة التي تُعدّ جزءًا من اختبار. أما بالنسبة إلى النماذج التي لا تمثّل اختبارات، فهي تعرض القيمة غير صحيحة.

تذكرة ذهاب وعودة

Boolean — ما إذا كان الاختيار يُعدّ إجابة صحيحة أم لا.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

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