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

Class CheckboxItem

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

// Open a form by ID and add a new checkbox item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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 إذا كان العنصر يحتوي على القيمة "other" خِيَارْ 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[]`	مصفوفة قيم الاختيار، التي يراها المستجيبون كتصنيفات عند عرض النموذج

الإرجاع

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.
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[]`	مصفوفة من الخيارات

الإرجاع

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.
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`	الملاحظات الجديدة. وسيؤدي استخدام القيمة الفارغة إلى محو الملاحظات.

الإرجاع

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`	التحقق من صحة مربع الاختيار لتطبيقه على هذا العنصر.

الإرجاع

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