Class CheckboxGridItem

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)

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

المَعلمات

الاسمالنوعالوصف
validationCheckboxGridValidation‫CheckboxGridValidation لتطبيقه على هذا العنصر

الإرجاع

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

التفويض

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

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