Class 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