خيار واحد مرتبط بنوع 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
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