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 لسؤال في شبكة مربّعات الاختيار غير مطلوب إلى عدم ردّ على ذلك الصف. توفّر استثناءً إذا لم يتطابق أي من القيم مع اختيار صالح.

المَعلمات

الاسمTypeالوصف
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)

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

المَعلمات

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

استرجاع الكرة

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

الرميات

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

التفويض

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

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

setHelpText(text)

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

المَعلمات

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

استرجاع الكرة

CheckboxGridItem — جهاز CheckboxGridItem هذا للسلاسل

التفويض

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

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

setRequired(enabled)

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

المَعلمات

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

استرجاع الكرة

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

التفويض

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

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

setRows(rows)

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

المَعلمات

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

استرجاع الكرة

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

الرميات

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

التفويض

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

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

setTitle(title)

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

المَعلمات

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

استرجاع الكرة

CheckboxGridItem — جهاز CheckboxGridItem هذا للسلاسل

التفويض

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

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

setValidation(validation)

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

المَعلمات

الاسمTypeالوصف
validationCheckboxGridValidationCheckboxGridصالحation لتطبيقها على هذا العنصر

استرجاع الكرة

CheckboxGridItem — جهاز CheckboxGridItem هذا للسلاسل

التفويض

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

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