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

Class ParagraphTextItem

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

// Open a form by ID and add a new paragraph text item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addParagraphTextItem();
item.setTitle('What is your address?');

الطُرق

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

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

`clearValidation()`

إزالة أي تحقق من البيانات لهذا العنصر النصي للفقرة.

الإرجاع

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

التفويض

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

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

`createResponse(response)`

إنشاء ItemResponse جديد لعنصر نص الفقرة هذا.

المعلمات

الاسم	النوع	الوصف
`response`	`String`	إجابة عن السؤال الذي يطرحه العنصر

الإرجاع

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

التفويض

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

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

`duplicate()`

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

الإرجاع

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

التفويض

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

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

`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

`isRequired()`

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

الإرجاع

Boolean: ما إذا كان يجب على المجيب الإجابة عن السؤال

التفويض

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

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

`setGeneralFeedback(feedback)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`setHelpText(text)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`setPoints(points)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`setRequired(enabled)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`setTitle(title)`

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

المعلمات

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

الإرجاع

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

التفويض

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

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

`setValidation(validation)`

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

المعلمات

الاسم	النوع	الوصف
`validation`	`ParagraphTextValidation`	a ParagraphTextValidation المُراد تطبيقها على هذا العنصر.

الإرجاع

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

التفويض

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

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