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

Class ScaleItem

عنصر سؤال يسمح للمجيب باختيار خيار واحد من تسلسل مرقم من الراديو الأزرار. يمكن الوصول إلى العناصر أو إنشاؤها من Form. عند استخدام هذه العناصر في اختبار، لتصنيفها.

// Open a form by ID and add a new scale item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addScaleItem();
item.setTitle('Pick a number between 1 and 10')
    .setBounds(1, 10);

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`createResponse(response)`	`ItemResponse`	تنشئ قيمة جديدة `ItemResponse` لعنصر المقياس هذا.
`duplicate()`	`ScaleItem`	إنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج
`getGeneralFeedback()`	`QuizFeedback`	تعرض الملاحظات التي تظهر للمستجيبين عند الرد على سؤال يمكن وضع درجات له.
`getHelpText()`	`String`	تحصل على نص المساعدة الخاص بالعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`getId()`	`Integer`	الحصول على المعرّف الفريد للعنصر
`getIndex()`	`Integer`	الحصول على فهرس العنصر بين جميع العناصر في النموذج.
`getLeftLabel()`	`String`	الحصول على تصنيف الحد الأدنى للمقياس، إن توفّر.
`getLowerBound()`	`Integer`	الحصول على الحد الأدنى للمقياس.
`getPoints()`	`Integer`	لعرض قيمة النقاط لعنصر قابل للدرجات.
`getRightLabel()`	`String`	الحصول على تصنيف الحدّ الأقصى للمقياس، إن توفّر.
`getTitle()`	`String`	يحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة استخدام `SectionHeaderItem`).
`getType()`	`ItemType`	تعرض هذه السمة نوع العنصر، ويتم تمثيله على أنّه `ItemType`.
`getUpperBound()`	`Integer`	الحصول على الحدّ الأقصى للمقياس
`isRequired()`	`Boolean`	تحدد ما إذا كان يجب على المجيب الإجابة على السؤال.
`setBounds(lower, upper)`	`ScaleItem`	لضبط الحدود الدنيا والعلوية للمقياس.
`setGeneralFeedback(feedback)`	`ScaleItem`	تعيِّن الملاحظات ليتم عرضها للمستجيبين عند الرد على سؤال يمكن وضع درجات له إجابة صحيحة أو غير صحيحة (مثل الأسئلة التي تتطلب وضع الدرجات يدويًا).
`setHelpText(text)`	`ScaleItem`	تحدِّد هذه السياسة نص المساعدة للعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`setLabels(lower, upper)`	`ScaleItem`	يعيّن التصنيفات للحدود الدنيا والعلوية للمقياس.
`setPoints(points)`	`ScaleItem`	تحدد عدد النقاط التي يستحقها العنصر الذي يمكن وضع درجات له.
`setRequired(enabled)`	`ScaleItem`	تحدد ما إذا كان يجب على المجيب الإجابة على السؤال.
`setTitle(title)`	`ScaleItem`	تضبط عنوان العنصر (يُسمّى أحيانًا نص العنوان، في حال استخدام `SectionHeaderItem`).

الوثائق التفصيلية

`createResponse(response)`

تنشئ قيمة جديدة ItemResponse لعنصر المقياس هذا. تعرض هذه السياسة استثناءً إذا كانت الوسيطة response خارج الحدود المعيّنة للعنصر.

المعلمات

الاسم	النوع	الوصف
`response`	`Integer`	إجابة عن قيمة عنصر المقياس هذا

الإرجاع

ItemResponse — الرد على العنصر

التفويض

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

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

`duplicate()`

إنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج

الإرجاع

ScaleItem — نسخة طبق الأصل من ScaleItem، للسلسلة

التفويض

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

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

`getGeneralFeedback()`

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

الإرجاع

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

`getLeftLabel()`

الحصول على تصنيف الحد الأدنى للمقياس، إن توفّر.

الإرجاع

String: تصنيف الحدّ الأدنى للمقياس

التفويض

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

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

`getLowerBound()`

الحصول على الحد الأدنى للمقياس.

الإرجاع

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

`getRightLabel()`

الحصول على تصنيف الحدّ الأقصى للمقياس، إن توفّر.

الإرجاع

String - تصنيف الحد الأعلى للمقياس

التفويض

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

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

`getUpperBound()`

الحصول على الحدّ الأقصى للمقياس

الإرجاع

Integer — الحد الأقصى للمقياس

التفويض

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

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

`setBounds(lower, upper)`

لضبط الحدود الدنيا والعلوية للمقياس. يجب أن يكون الحد الأدنى 0 أو 1. تشير رسالة الأشكال البيانية يجب أن يتراوح الحد الأقصى بين 3 و10 بشكل شامل. يكون المقياس الجديد تلقائيًا حد أدنى يبلغ 1 وحد أعلى يبلغ 5.

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

المعلمات

الاسم	النوع	الوصف
`lower`	`Integer`	الحد الأدنى الجديد
`upper`	`Integer`	الحد الأقصى الجديد

الإرجاع

ScaleItem — ScaleItem هذا، للسلسلة

الرميات

Error: إذا كان الحدّ الأدنى أو الأعلى غير صالح

التفويض

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

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

`setGeneralFeedback(feedback)`

تعيِّن الملاحظات ليتم عرضها للمستجيبين عند الرد على سؤال يمكن وضع درجات له إجابة صحيحة أو غير صحيحة (مثل الأسئلة التي تتطلب وضع الدرجات يدويًا).

المعلمات

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

الإرجاع

ScaleItem — ScaleItem هذا، للسلسلة

التفويض

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

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

`setHelpText(text)`

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

المعلمات

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

الإرجاع

ScaleItem — ScaleItem هذا، للسلسلة

التفويض

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

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

`setLabels(lower, upper)`

يعيّن التصنيفات للحدود الدنيا والعلوية للمقياس.

المعلمات

الاسم	النوع	الوصف
`lower`	`String`	التسمية الجديدة للحد الأدنى
`upper`	`String`	التسمية الجديدة للحد الأعلى

الإرجاع

ScaleItem — ScaleItem هذا، للسلسلة

التفويض

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

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

`setPoints(points)`

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

المعلمات

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

الإرجاع

ScaleItem — ScaleItem هذا، للسلسلة

التفويض

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

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

`setRequired(enabled)`

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

المعلمات

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

الإرجاع

ScaleItem — العنصر الحالي (للسلسلة)

التفويض

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

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

`setTitle(title)`

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

المعلمات

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

الإرجاع

ScaleItem — ScaleItem هذا، للسلسلة

التفويض

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

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