Class CheckboxItem

مربّع اختيارالعنصر

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

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
      item.createChoice('Ketchup'),
      item.createChoice('Mustard'),
      item.createChoice('Relish'),
    ])
    .showOtherOption(true);

الطُرق

الطريقة	نوع القيمة التي يتم عرضها	وصف قصير
clearValidation()	CheckboxItem	تزيل أي عملية تحقّق من صحة البيانات لهذا العنصر من مربّع الاختيار.
createChoice(value)	Choice	لإنشاء خيار جديد.
createChoice(value, isCorrect)	Choice	لإنشاء خيار جديد.
createResponse(responses)	ItemResponse	لإنشاء ItemResponse جديد لعنصر مربّع الاختيار هذا.
duplicate()	CheckboxItem	تُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
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)	CheckboxItem	تُستخدَم لضبط خيارات عنصر من مصفوفة سلاسل.
setChoices(choices)	CheckboxItem	تُستخدَم لضبط مصفوفة من الخيارات لعنصر معيّن.
setFeedbackForCorrect(feedback)	CheckboxItem	لضبط الملاحظات التي ستظهر للمستجيبين عند إجابتهم بشكل صحيح عن سؤال.
setFeedbackForIncorrect(feedback)	CheckboxItem	لضبط الملاحظات التي ستظهر للمجيبين عندما يجيبون بشكل غير صحيح عن سؤال.
setHelpText(text)	CheckboxItem	لضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setPoints(points)	CheckboxItem	لضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف.
setRequired(enabled)	CheckboxItem	لتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setTitle(title)	CheckboxItem	لضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem)
setValidation(validation)	CheckboxItem	تُستخدَم لضبط ميزة التحقّق من صحة البيانات لعنصر مربّع الاختيار هذا.
showOtherOption(enabled)	CheckboxItem	لتحديد ما إذا كان العنصر يتضمّن خيار "غير ذلك".

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

clearValidation()

تزيل أي عملية تحقّق من صحة البيانات لهذا العنصر من مربّع الاختيار.

الإرجاع

CheckboxItem — هذا الرمز CheckboxItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

---

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

---

createResponse(responses)

لإنشاء ItemResponse جديد لعنصر مربّع الاختيار هذا. الوسيطة responses هي صفيف String[] يحتوي على القيم التي يجب التحقّق منها. يُلقي استثناءً إذا لم تتطابق أي قيمة مع خيار صالح لهذا العنصر، ما لم يتم ضبط showOtherOption(enabled) على true.

المعلَمات

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

الإرجاع

ItemResponse - استجابة السلعة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

---

duplicate()

تُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.

الإرجاع

CheckboxItem: نسخة طبق الأصل من هذا CheckboxItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

• 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

المعلَمات

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

الإرجاع

CheckboxItem — هذا الرمز CheckboxItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

• 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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

المعلَمات

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

الإرجاع

CheckboxItem — هذا الرمز CheckboxItem، لإنشاء سلسلة

عمليات الرمي

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.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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	الملاحظات الجديدة. ستؤدي القيمة الخالية إلى محو الملاحظات.

الإرجاع

CheckboxItem — هذا الرمز CheckboxItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

---

setFeedbackForIncorrect(feedback)

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

المعلَمات

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

الإرجاع

CheckboxItem — هذا الرمز CheckboxItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

---

setHelpText(text)

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

المعلَمات

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

الإرجاع

CheckboxItem — هذا الرمز CheckboxItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

---

setPoints(points)

لضبط عدد النقاط التي يستحقها عنصر قابل للتصنيف. القيمة التلقائية للعناصر الجديدة هي 0.

المعلَمات

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

الإرجاع

CheckboxItem — هذا الرمز CheckboxItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

---

setRequired(enabled)

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

المعلَمات

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

الإرجاع

CheckboxItem: العنصر الحالي (للتسلسل)

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

---

setTitle(title)

لضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem)

المعلَمات

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

الإرجاع

CheckboxItem — هذا الرمز CheckboxItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

---

setValidation(validation)

تُستخدَم لضبط ميزة التحقّق من صحة البيانات لعنصر مربّع الاختيار هذا. سيؤدي إدخال قيمة فارغة أو عملية تحقّق بدون استدعاء أي دالات متطلبات إلى إزالة أي عملية تحقّق سابقة.

المعلَمات

الاسم	النوع	الوصف
validation	CheckboxValidation	عنصر CheckboxValidation لتطبيقه على هذا العنصر

الإرجاع

CheckboxItem — هذا الرمز CheckboxItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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

---

showOtherOption(enabled)

لتحديد ما إذا كان العنصر يتضمّن خيار "غير ذلك". القيمة التلقائية لعنصر CheckboxItem أو MultipleChoiceItem الجديد هو false.

المعلَمات

الاسم	النوع	الوصف
enabled	Boolean	true إذا كان العنصر يتضمّن خيار "غير ذلك"، false إذا لم يكن الأمر كذلك

الإرجاع

CheckboxItem — هذا الرمز CheckboxItem، لإنشاء سلسلة

التفويض

تتطلّب النصوص البرمجية التي تستخدِم هذه الطريقة الحصول على إذن واحد أو أكثر من النطاقات التالية:

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