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

Class CheckboxItem

عنصر سؤال يتيح للمجيب اختيار مربّع اختيار واحد أو أكثر، بالإضافة إلى الحقل الاختياري "other" يمكن الوصول إلى العناصر أو إنشاؤها من 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`	تحدد ما إذا كان العنصر يحتوي على خيار "other".

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

`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.
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)`

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

المعلّمات

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

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

CheckboxItem - هذا CheckboxItem، للسلاسل

التفويض

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

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