تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

Class MultipleChoiceItem

عنصر سؤال يسمح للمجيب باختيار واحد من قائمة أزرار الاختيار أو حقل اختياري "غير ذلك". يمكن الوصول إلى العناصر أو إنشاؤها من Form. عند استخدامها في اختبار، يتم وضع الدرجات لها تلقائيًا.

// Open a form by ID and add a new multiple choice item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addMultipleChoiceItem();
item.setTitle('Do you prefer cats or dogs?')
    .setChoices([
        item.createChoice('Cats'),
        item.createChoice('Dogs')
     ])
    .showOtherOption(true);

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`createChoice(value)`	`Choice`	لإنشاء خيار جديد.
`createChoice(value, isCorrect)`	`Choice`	لإنشاء خيار جديد.
`createChoice(value, navigationItem)`	`Choice`	يُنشئ خيارًا جديدًا مع خيار التنقل في الصفحة الذي ينتقل مباشرةً إلى عنصر فاصل صفحة معيّن.
`createChoice(value, navigationType)`	`Choice`	لإنشاء خيار جديد مع خيار التنقل في الصفحة.
`createResponse(response)`	`ItemResponse`	إنشاء `ItemResponse` جديد لهذا العنصر المتعدد الخيارات.
`duplicate()`	`MultipleChoiceItem`	إنشاء نسخة من هذا العنصر وإلحاقه بنهاية النموذج.
`getChoices()`	`Choice[]`	الحصول على جميع الخيارات لأحد العناصر.
`getFeedbackForCorrect()`	`QuizFeedback`	عرض الملاحظات التي يتم عرضها للمجيبين عند الرد بشكل صحيح على أحد الأسئلة.
`getFeedbackForIncorrect()`	`QuizFeedback`	عرض الملاحظات التي يتم عرضها للمجيبين عند الرد بشكل غير صحيح على سؤال.
`getHelpText()`	`String`	الحصول على نص المساعدة للعنصر (يُطلق عليه أحيانًا اسم الوصف لعناصر التنسيق، مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`getId()`	`Integer`	للحصول على المعرّف الفريد للعنصر.
`getIndex()`	`Integer`	للحصول على فهرس العنصر بين جميع العناصر في النموذج.
`getPoints()`	`Integer`	لعرض قيمة النقطة لعنصر يمكن وضع درجاته.
`getTitle()`	`String`	يحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة `SectionHeaderItem`).
`getType()`	`ItemType`	تحصل على نوع العنصر، ويمثل `ItemType`.
`hasOtherOption()`	`Boolean`	تحدِّد ما إذا كان العنصر يحتوي على خيار "غير ذلك".
`isRequired()`	`Boolean`	يحدّد ما إذا كان يجب على المجيب أن يجيب عن السؤال.
`setChoiceValues(values)`	`MultipleChoiceItem`	تضبط هذه السمة الخيارات لعنصر من مصفوفة من سلاسل.
`setChoices(choices)`	`MultipleChoiceItem`	لضبط مصفوفة من الخيارات لأحد العناصر.
`setFeedbackForCorrect(feedback)`	`MultipleChoiceItem`	تتيح ضبط التعليقات التي يتم عرضها على المجيبين عند الرد بشكل صحيح على سؤال.
`setFeedbackForIncorrect(feedback)`	`MultipleChoiceItem`	إعداد الملاحظات التي سيتم عرضها على المجيبين عند الرد على سؤال بشكل غير صحيح.
`setHelpText(text)`	`MultipleChoiceItem`	تُحدِّد نص مساعدة العنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`setPoints(points)`	`MultipleChoiceItem`	يحدّد عدد النقاط التي يمكن تطبيقها على العنصر القابل لوضع الدرجات.
`setRequired(enabled)`	`MultipleChoiceItem`	يحدّد هذا الإعداد ما إذا كان على المجيب الإجابة عن السؤال.
`setTitle(title)`	`MultipleChoiceItem`	تحدد عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة `SectionHeaderItem`).
`showOtherOption(enabled)`	`MultipleChoiceItem`	تحدد ما إذا كان العنصر يحتوي على خيار "other".

المستندات التفصيلية

`createChoice(value)`

لإنشاء خيار جديد.

المعلّمات

الاسم	النوع	الوصف
`value`	`String`	قيمة الاختيار، والتي يراها المجيبون كتصنيف عند عرض النموذج

تذكرة ذهاب وعودة

Choice — الخيار الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`createChoice(value, isCorrect)`

لإنشاء خيار جديد.

المعلّمات

الاسم	النوع	الوصف
`value`	`String`	قيمة الاختيار، والتي يراها المجيبون كتصنيف عند عرض النموذج
`isCorrect`	`Boolean`	ما إذا كان الاختيار يُعدّ إجابة صحيحة

تذكرة ذهاب وعودة

Choice — الخيار الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`createChoice(value, navigationItem)`

يُنشئ خيارًا جديدًا مع خيار التنقل في الصفحة الذي ينتقل مباشرةً إلى عنصر فاصل صفحة معيّن. هذا يعادل createChoice(value, navigationType) مع ضبط navigationType على FormApp.PageNavigationType.GO_TO_PAGE. لا يمكن الجمع بين الخيارات التي تستخدم التنقّل في الصفحة في العنصر نفسه مع الخيارات التي لا تستخدم التنقّل في الصفحة.

يتم التنقّل في الصفحة بعد إكمال المستجيب لصفحة تحتوي على الخيار، وفقط إذا اختار المجيب هذا الخيار. إذا اختار المجيب خيارات متعددة مع إرشادات التنقل في الصفحة نفسها، فلن يؤثر سوى خيار التنقل الأخير. ولن يكون للتنقّل في الصفحة أي تأثير في الصفحة الأخيرة من النموذج.

المعلّمات

الاسم	النوع	الوصف
`value`	`String`	قيمة الاختيار، والتي يراها المجيبون كتصنيف عند عرض النموذج
`navigationItem`	`PageBreakItem`	العنصر الذي تريد الانتقال إليه

تذكرة ذهاب وعودة

Choice — الخيار الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`createChoice(value, navigationType)`

لإنشاء خيار جديد مع خيار التنقل في الصفحة. لا يمكن الجمع بين الخيارات التي تستخدم التنقل في الصفحة في العنصر نفسه مع الخيارات التي لا تستخدم التنقل في الصفحة.

المعلّمات

الاسم	النوع	الوصف
`value`	`String`	قيمة الاختيار، والتي يراها المجيبون كتصنيف عند عرض النموذج
`navigationType`	`PageNavigationType`	نوع التنقل على شبكة الاختيار

تذكرة ذهاب وعودة

Choice — الخيار الجديد

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`createResponse(response)`

إنشاء ItemResponse جديد لهذا العنصر المتعدد الخيارات. ويتم عرض استثناء إذا كانت الوسيطة response لا تتطابق مع خيار صالح لهذا العنصر، ما لم يتم ضبط showOtherOption(enabled) على true.

المعلّمات

الاسم	النوع	الوصف
`response`	`String`	إجابة صالحة لهذا العنصر متعدّد الخيارات

تذكرة ذهاب وعودة

ItemResponse - الرد على السلعة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`duplicate()`

إنشاء نسخة من هذا العنصر وإلحاقه بنهاية النموذج.

تذكرة ذهاب وعودة

MultipleChoiceItem - نسخة طبق الأصل من هذا MultipleChoiceItem، للسلسلة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getChoices()`

الحصول على جميع الخيارات لأحد العناصر.

تذكرة ذهاب وعودة

Choice[]: مصفوفة من الخيارات

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getFeedbackForCorrect()`

عرض الملاحظات التي يتم عرضها للمجيبين عند الرد بشكل صحيح على أحد الأسئلة.

تذكرة ذهاب وعودة

QuizFeedback - الملاحظات، إن وُجدت.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getFeedbackForIncorrect()`

عرض الملاحظات التي يتم عرضها للمجيبين عند الرد بشكل غير صحيح على سؤال.

تذكرة ذهاب وعودة

QuizFeedback - الملاحظات، إن وُجدت.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getHelpText()`

الحصول على نص المساعدة للعنصر (يُطلق عليه أحيانًا اسم الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).

تذكرة ذهاب وعودة

String — نص المساعدة أو نص الوصف

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getId()`

للحصول على المعرّف الفريد للعنصر.

تذكرة ذهاب وعودة

Integer — رقم تعريف العنصر

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getIndex()`

للحصول على فهرس العنصر بين جميع العناصر في النموذج.

تذكرة ذهاب وعودة

Integer — فهرس السلعة

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getPoints()`

لعرض قيمة النقطة لعنصر يمكن وضع درجاته.

تذكرة ذهاب وعودة

Integer: عدد النقاط التي يستحقها السؤال.

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getTitle()`

يحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem).

تذكرة ذهاب وعودة

String — عنوان السلعة أو نص العنوان

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`getType()`

تحصل على نوع العنصر، ويمثل ItemType.

تذكرة ذهاب وعودة

ItemType — نوع العنصر

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`hasOtherOption()`

تحدِّد ما إذا كان العنصر يحتوي على خيار "غير ذلك".

تذكرة ذهاب وعودة

Boolean — true إذا كان العنصر يحتوي على خيار &"غير ذلك&;; بينما false يحتوي على

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`isRequired()`

يحدّد ما إذا كان يجب على المجيب أن يجيب عن السؤال.

تذكرة ذهاب وعودة

Boolean — ما إذا كان على المجيب الإجابة عن السؤال

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setChoiceValues(values)`

تضبط هذه السمة الخيارات لعنصر من مصفوفة من سلاسل. ويتم عرض استثناء إذا كانت المصفوفة المحدّدة فارغة.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

المعلّمات

الاسم	النوع	الوصف
`values`	`String[]`	مصفوفة قيم الاختيار التي يراها المجيبون كتصنيفات عند عرض النموذج

تذكرة ذهاب وعودة

MultipleChoiceItem - هذا MultipleChoiceItem، للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setChoices(choices)`

لضبط مصفوفة من الخيارات لأحد العناصر. لعرض استثناء إذا كانت المصفوفة المحدّدة فارغة أو تحتوي على عنصر null

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?')
item.setChoices([
    item.createChoice('Cats'),
    item.createChoice('Dogs')
]);

المعلّمات

الاسم	النوع	الوصف
`choices`	`Choice[]`	مجموعة من الخيارات

تذكرة ذهاب وعودة

MultipleChoiceItem - هذا MultipleChoiceItem، للسلاسل

طرح

Error — إذا كانت المصفوفة المحدّدة هي null أو فارغة أو تحتوي على عنصر null

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setFeedbackForCorrect(feedback)`

تتيح ضبط التعليقات التي يتم عرضها على المجيبين عند الرد بشكل صحيح على سؤال.

// Open a form by ID and add a new list item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false)]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText("Dogs rule, cats drool.").build());

المعلّمات

الاسم	النوع	الوصف
`feedback`	`QuizFeedback`	الملاحظات الجديدة. وستؤدي القيمة الفارغة إلى محو الملاحظات.

تذكرة ذهاب وعودة

MultipleChoiceItem - هذا MultipleChoiceItem، للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setFeedbackForIncorrect(feedback)`

إعداد الملاحظات التي سيتم عرضها على المجيبين عند الرد على سؤال بشكل غير صحيح.

المعلّمات

الاسم	النوع	الوصف
`feedback`	`QuizFeedback`	الملاحظات الجديدة

تذكرة ذهاب وعودة

MultipleChoiceItem - هذا MultipleChoiceItem، للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setHelpText(text)`

تُحدِّد نص مساعدة العنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).

المعلّمات

الاسم	النوع	الوصف
`text`	`String`	نص المساعدة الجديد

تذكرة ذهاب وعودة

MultipleChoiceItem - هذا MultipleChoiceItem، للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setPoints(points)`

يحدّد عدد النقاط التي يمكن تطبيقها على العنصر القابل لوضع الدرجات. القيمة التلقائية للعناصر الجديدة هي 0.

المعلّمات

الاسم	النوع	الوصف
`points`	`Integer`	عدد النقاط التي يساويها عنصر سؤال

تذكرة ذهاب وعودة

MultipleChoiceItem - هذا MultipleChoiceItem، للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setRequired(enabled)`

يحدّد هذا الإعداد ما إذا كان على المجيب الإجابة عن السؤال.

المعلّمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	ما إذا كان يجب على المُجيب الإجابة عن السؤال

تذكرة ذهاب وعودة

MultipleChoiceItem - العنصر الحالي (للسلسلة)

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`setTitle(title)`

تحدد عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem).

المعلّمات

الاسم	النوع	الوصف
`title`	`String`	العنوان الجديد أو نص العنوان الجديد

تذكرة ذهاب وعودة

MultipleChoiceItem - هذا MultipleChoiceItem، للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms

`showOtherOption(enabled)`

تحدد ما إذا كان العنصر يحتوي على خيار "other". الإعداد التلقائي الجديد لـ CheckboxItem أو MultipleChoiceItem هو false.

المعلّمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	`true` إذا كان العنصر يحتوي على خيار "other";؛ `false` إذا لم يكن

تذكرة ذهاب وعودة

MultipleChoiceItem - هذا MultipleChoiceItem، للسلاسل

التفويض

تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:

https://www.googleapis.com/auth/forms.currentonly
https://www.googleapis.com/auth/forms