تمت ترجمة هذه الصفحة بواسطة 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 — الحد الأدنى للمقياس&39

التفويض

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

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