Class CheckboxGridItem

CheckboxGridItem

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

// Open a form by ID and add a new checkgox grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addCheckboxGridItem();
item.setTitle('Where did you celebrate New Years?')
  .setRows(['New York', 'San Francisco', 'London'])
  .setColumns(['2014', '2015', '2016', '2017']);

الطُرق

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

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

clearValidation()

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

الإرجاع

CheckboxGridItem: هذا العنصر للسلسلة

التفويض

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

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

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

الإرجاع

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

التفويض

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

  • 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[]مصفوفة من قيم الأعمدة، والتي يراها المستجيبون كتصنيفات عند عرض النموذج

الإرجاع

CheckboxGridItem: هذا العنصر للسلسلة

الرميات

Error: إذا كان الصفيف المحدَّد null أو فارغًا

التفويض

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

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

setHelpText(text)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setRequired(enabled)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setRows(rows)

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

المعلمات

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

الإرجاع

CheckboxGridItem: هذا العنصر للسلسلة

الرميات

Error: إذا كان الصفيف المحدَّد null أو فارغًا

التفويض

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

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

setTitle(title)

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

المعلمات

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

الإرجاع

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

التفويض

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

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

setValidation(validation)

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

المعلمات

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

الإرجاع

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

التفويض

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

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