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

Class ScaleItem

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

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

الطُرق

الطريقة	نوع القيمة التي يتم إرجاعها	وصف قصير
`createResponse(response)`	`ItemResponse`	تُنشئ هذه السمة `ItemResponse` جديدًا لعنصر المقياس هذا.
`duplicate()`	`ScaleItem`	ينشئ نسخة من هذا العنصر ويضيفها إلى نهاية النموذج.
`getGeneralFeedback()`	`QuizFeedback\|null`	تعرض هذه السمة الملاحظات التي تظهر للمستجيبين عند الإجابة عن سؤال قابل للتقييم.
`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|null: الملاحظات، إن وُجدت.

التفويض

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

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

Class ScaleItem تنظيم صفحاتك في مجموعات يمكنك حفظ المحتوى وتصنيفه حسب إعداداتك المفضّلة.

الطُرق

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

createResponse(response)

المعلمات

الإرجاع

التفويض

duplicate()

الإرجاع

التفويض

getGeneralFeedback()

الإرجاع

التفويض

getHelpText()

الإرجاع

التفويض

getId()

الإرجاع

التفويض

getIndex()

الإرجاع

التفويض

getLeftLabel()

الإرجاع

التفويض

getLowerBound()

الإرجاع

التفويض

getPoints()

الإرجاع

التفويض

getRightLabel()

الإرجاع

التفويض

getTitle()

الإرجاع

التفويض

getType()

الإرجاع

التفويض

getUpperBound()

الإرجاع

التفويض

isRequired()

الإرجاع

التفويض

setBounds(lower, upper)

المعلمات

الإرجاع

الرميات

التفويض

setGeneralFeedback(feedback)

المعلمات

الإرجاع

التفويض

setHelpText(text)

المعلمات

الإرجاع

التفويض

setLabels(lower, upper)

المعلمات

الإرجاع

التفويض

setPoints(points)

المعلمات

الإرجاع

التفويض

setRequired(enabled)

المعلمات

الإرجاع

التفويض

setTitle(title)

المعلمات

الإرجاع

التفويض

Class ScaleItem

`createResponse(response)`

`duplicate()`

`getGeneralFeedback()`

`getHelpText()`

`getId()`

`getIndex()`

`getLeftLabel()`

`getLowerBound()`

`getPoints()`

`getRightLabel()`

`getTitle()`

`getType()`

`getUpperBound()`

`isRequired()`

`setBounds(lower, upper)`

`setGeneralFeedback(feedback)`

`setHelpText(text)`

`setLabels(lower, upper)`

`setPoints(points)`

`setRequired(enabled)`

`setTitle(title)`