Class GridItem

الشبكةالعنصر

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

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

الطُرق

الطريقةنوع القيمة التي يتم عرضهاوصف قصير
clearValidation()GridItemتزيل أي عملية تحقّق من صحة البيانات لعنصر الشبكة هذا.
createResponse(responses)ItemResponseلإنشاء ItemResponse جديدة لعنصر الشبكة هذا
duplicate()GridItemتُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.
getColumns()String[]تحصل على قيم كل عمود في الشبكة.
getHelpText()Stringللحصول على نص مساعدة السلعة (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
getId()Integerالحصول على المعرّف الفريد للعنصر
getIndex()Integerتحصل على فهرس العنصر من بين جميع العناصر في النموذج.
getRows()String[]تحصل على قيم كل صف في الشبكة.
getTitle()Stringتحصل على عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem).
getType()ItemTypeتحصل على نوع العنصر الذي يتم تمثيله كـ ItemType.
isRequired()Booleanلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setColumns(columns)GridItemتُستخدَم لضبط أعمدة الشبكة استنادًا إلى صفيف من القيم.
setHelpText(text)GridItemلضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).
setRequired(enabled)GridItemلتحديد ما إذا كان على المجيب الإجابة عن السؤال.
setRows(rows)GridItemتضبط صفوف الشبكة استنادًا إلى صفيف من القيم.
setTitle(title)GridItemلضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)
setValidation(validation)GridItemتُستخدَم لضبط ميزة التحقّق من صحة البيانات لعنصر الشبكة هذا.

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

clearValidation()

تزيل أي عملية تحقّق من صحة البيانات لعنصر الشبكة هذا.

الإرجاع

GridItem - هذا العنصر، لتسلسل العناصر

التفويض

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

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

createResponse(responses)

لإنشاء ItemResponse جديدة لعنصر الشبكة هذا يجب أن تكون الوسيطة responses مصفوفة String[] تحتوي على عدد القيم نفسه لعدد الصفوف في الشبكة. يشير عنصر null لسؤال شبكة غير مطلوب إلى عدم توفّر ردّ على ذلك الصف. يُلقي ملف برمجي استثناءً إذا لم تتطابق أيّ من القيم مع خيار صالح.

المعلمات

الاسمالنوعالوصف
responsesString[]مصفوفة من الإجابات الصالحة لعنصر الشبكة هذا

الإرجاع

ItemResponse - استجابة السلعة

التفويض

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

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

duplicate()

تُنشئ هذه الدالة نسخة من هذا العنصر وتُلحقها بنهاية النموذج.

الإرجاع

GridItem: نسخة طبق الأصل من هذا GridItem، لإنشاء سلسلة

التفويض

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

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

getColumns()

تحصل على قيم كل عمود في الشبكة.

الإرجاع

String[]: صفيف من قيم الأعمدة التي تظهر للمجيبين كتسميات عند عرض النموذج

التفويض

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

  • 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

getRows()

تحصل على قيم كل صف في الشبكة.

الإرجاع

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

isRequired()

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

الإرجاع

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

التفويض

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

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

setColumns(columns)

تُستخدَم لضبط أعمدة الشبكة استنادًا إلى صفيف من القيم. يُعرِض استثناءً إذا كانت السلسلة المُعطاة فارغة.

المعلمات

الاسمالنوعالوصف
columnsString[]صفيف من قيم الأعمدة التي تظهر للمجيبين كتسميات عند عرض النموذج

الإرجاع

GridItem - هذا العنصر، لتسلسل العناصر

عمليات الرمي

Error - إذا كانت المصفوفة المحدّدة هي null أو فارغة

التفويض

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

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

setHelpText(text)

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

المعلمات

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

الإرجاع

GridItem — هذا GridItem، لإنشاء سلسلة

التفويض

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

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

setRequired(enabled)

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

المعلمات

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

الإرجاع

GridItem: العنصر الحالي (للتسلسل)

التفويض

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

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

setRows(rows)

تضبط صفوف الشبكة استنادًا إلى صفيف من القيم. يُعرِض استثناءً إذا كانت الصفيف المُعطاة فارغة.

المعلمات

الاسمالنوعالوصف
rowsString[]صفيف من قيم الصفوف التي تظهر للمجيبين كعلامات عند عرض النموذج

الإرجاع

GridItem - هذا العنصر، لتسلسل العناصر

عمليات الرمي

Error - إذا كانت المصفوفة المحدّدة هي null أو فارغة

التفويض

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

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

setTitle(title)

لضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال استخدام SectionHeaderItem)

المعلمات

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

الإرجاع

GridItem — هذا GridItem، لإنشاء سلسلة

التفويض

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

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

setValidation(validation)

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

المعلمات

الاسمالنوعالوصف
validationGridValidationعنصر GridValidation لتطبيقه على هذا العنصر

الإرجاع

GridItem — هذا GridItem، لإنشاء سلسلة

التفويض

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

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