Class GridItem

GridItem

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

// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var 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)

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

المعلمات

الاسمالنوعالوصف
validationGridValidationa GridValidation (التحقّق من الصحة) لتطبيقه على هذا العنصر.

الإرجاع

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

التفويض

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

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