تمت ترجمة هذه الصفحة بواسطة 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`	تحدِّد هذه السمة ما إذا كان العنصر يحتوي على خيار "other".
`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)`

ينشئ خيارًا جديدًا.

المَعلمات

الاسم	Type	الوصف
`value`	`String`	قيمة الخيار، والتي يراها المستجيبون كتصنيف عند عرض النموذج

استرجاع الكرة

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

التفويض

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

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

`createChoice(value, isCorrect)`

ينشئ خيارًا جديدًا.

المَعلمات

الاسم	Type	الوصف
`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.

المَعلمات

الاسم	Type	الوصف
`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()`

تحدِّد هذه السمة ما إذا كان العنصر يحتوي على خيار "other".

استرجاع الكرة

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

المَعلمات

الاسم	Type	الوصف
`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')
]);

المَعلمات

الاسم	Type	الوصف
`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());

المَعلمات

الاسم	Type	الوصف
`feedback`	`QuizFeedback`	الملاحظات الجديدة. سيؤدي استخدام قيمة فارغة إلى محو الملاحظات.

استرجاع الكرة

CheckboxItem — جهاز CheckboxItem هذا للسلاسل

التفويض

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

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

`setFeedbackForIncorrect(feedback)`

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

المَعلمات

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

استرجاع الكرة

CheckboxItem — جهاز CheckboxItem هذا للسلاسل

التفويض

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

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

`setHelpText(text)`

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

المَعلمات

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

استرجاع الكرة

CheckboxItem — جهاز CheckboxItem هذا للسلاسل

التفويض

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

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

`setPoints(points)`

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

المَعلمات

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

استرجاع الكرة

CheckboxItem — جهاز CheckboxItem هذا للسلاسل

التفويض

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

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

`setRequired(enabled)`

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

`setTitle(title)`

لضبط عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem).

المَعلمات

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

استرجاع الكرة

CheckboxItem — جهاز CheckboxItem هذا للسلاسل

التفويض

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

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

`setValidation(validation)`

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

المَعلمات

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

استرجاع الكرة

CheckboxItem — جهاز CheckboxItem هذا للسلاسل

التفويض

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

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

`showOtherOption(enabled)`

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

المَعلمات

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

استرجاع الكرة

CheckboxItem — جهاز CheckboxItem هذا للسلاسل

التفويض

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

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