Class CheckboxGridItem

مربّع اختيارشبكةعنصر

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

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