Class CheckboxItem

CheckboxItem

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

// 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|null	تعرض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون بشكل صحيح عن سؤال.
getFeedbackForIncorrect()	QuizFeedback|null	تعرِض هذه السمة الملاحظات التي تظهر للمجيبين عندما يجيبون عن سؤال بشكل غير صحيح.
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|null: الملاحظات، إن وُجدت.

التفويض

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

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

---

getFeedbackForIncorrect()

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

الإرجاع

QuizFeedback|null: الملاحظات، إن وُجدت.

التفويض

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

• 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)

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

المعلمات

الاسم	النوع	الوصف
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