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