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)

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

المعلمات

الاسمالنوعالوصف
valueStringقيمة الخيار التي تظهر للمجيبين على أنّها تصنيف عند عرض النموذج

الإرجاع

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

التفويض

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

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

createChoice(value, isCorrect)

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

المعلمات

الاسمالنوعالوصف
valueStringقيمة الخيار التي تظهر للمجيبين على أنّها تصنيف عند عرض النموذج
isCorrectBooleanما إذا كان الخيار هو إجابة صحيحة

الإرجاع

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

التفويض

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

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

createResponse(responses)

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

المعلمات

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

الإرجاع

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']);

المعلمات

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

الإرجاع

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')]);

المعلمات

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

الإرجاع

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(),
);

المعلمات

الاسمالنوعالوصف
feedbackQuizFeedbackالملاحظات الجديدة. ستؤدي القيمة الخالية إلى محو الملاحظات.

الإرجاع

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

التفويض

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

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

setFeedbackForIncorrect(feedback)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setHelpText(text)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setPoints(points)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setRequired(enabled)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setTitle(title)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setValidation(validation)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

showOtherOption(enabled)

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

المعلمات

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

الإرجاع

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

التفويض

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

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