Class Choice

Choice

خيار واحد مرتبط بنوع من Item يتيح خيارات، مثل CheckboxItem أو ListItem أو MultipleChoiceItem

// Create a new form and add a multiple-choice item.
const form = FormApp.create('Form Name');
const 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.
const choices = item.getChoices();
for (let 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