Class TextItem

TextItem

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

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

الطُرق

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

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

clearValidation()

يؤدي هذا الإجراء إلى إزالة أيّ عملية تحقّق من صحة البيانات لهذا العنصر النصي.

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

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

التفويض

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

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

createResponse(response)

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

المَعلمات

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

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

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

التفويض

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

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

duplicate()

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

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

TextItem: نسخة طبق الأصل من TextItem، للتسلسل

التفويض

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

  • 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)

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

المَعلمات

الاسمTypeالوصف
feedbackQuizFeedbackالملاحظات الجديدة

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

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

التفويض

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

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

setHelpText(text)

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

المَعلمات

الاسمTypeالوصف
textStringنص المساعدة الجديد

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

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

التفويض

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

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

setPoints(points)

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

المَعلمات

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

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

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

التفويض

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

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

setRequired(enabled)

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

المَعلمات

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

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

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

التفويض

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

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

setTitle(title)

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

المَعلمات

الاسمTypeالوصف
titleStringالعنوان الجديد أو نص العنوان

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

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

التفويض

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

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

setValidation(validation)

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

المَعلمات

الاسمTypeالوصف
validationTextValidationالتحقق من النص لتطبيقه على هذا العنصر.

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

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

التفويض

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

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