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