عنصر سؤال يتم تقديمه في شكل شبكة من الأعمدة والصفوف، يسمح للمجيب بتحديد عدة خيارات لكل صف من سلسلة من مربعات الاختيار. يمكن الوصول إلى العناصر أو إنشاؤها من
"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 | الوصف |
---|---|---|
responses | String[][] | مجموعة من صفائف الإجابات الصالحة لعنصر شبكة مربّع الاختيار هذا |
استرجاع الكرة
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()
isRequired()
تحدد ما إذا كان يجب على المجيب الإجابة على السؤال.
استرجاع الكرة
Boolean
: لتحديد ما إذا كان على المجيب الإجابة عن السؤال
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
لتعيين أعمدة الشبكة استنادًا إلى صفيف من القيم. تنشئ استثناء إذا كان الصفيف المحدد فارغًا.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
columns | String[] | مصفوفة من قيم الأعمدة، والتي يراها المستجيبون كتصنيفات عند عرض النموذج |
استرجاع الكرة
CheckboxGridItem
: هذا العنصر للسلاسل
الرميات
Error
: إذا كان الصفيف المحدّد null
أو فارغًا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
تعمل هذه السياسة على ضبط نص المساعدة الخاص بالعنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems
وPageBreakItems
وSectionHeaderItems
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
text | String | نص المساعدة الجديد |
استرجاع الكرة
CheckboxGridItem
— جهاز CheckboxGridItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
تحدِّد هذه السياسة ما إذا كان على المجيب الإجابة عن السؤال.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
enabled | Boolean | ما إذا كان يجب على المجيب الإجابة على السؤال |
استرجاع الكرة
CheckboxGridItem
- العنصر الحالي (للسلاسل)
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
لتعيين صفوف الشبكة استنادًا إلى صفيف من القيم. تطرح استثناء إذا كانت الصفيفة المحددة فارغة.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
rows | String[] | مصفوفة من قيم الصفوف، والتي يراها المستجيبون كتصنيفات عند عرض النموذج |
استرجاع الكرة
CheckboxGridItem
: هذا العنصر للسلاسل
الرميات
Error
: إذا كان الصفيف المحدّد null
أو فارغًا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
لضبط عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
title | String | العنوان الجديد أو نص العنوان |
استرجاع الكرة
CheckboxGridItem
— جهاز CheckboxGridItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
لضبط التحقق من صحة البيانات لعنصر شبكة مربع الاختيار هذا. سيؤدي تمرير قيمة فارغة أو التحقق من الصحة دون أي دوال تتطلب استدعاء إلى إزالة أي تحقق سابق.
المَعلمات
الاسم | Type | الوصف |
---|---|---|
validation | CheckboxGridValidation | CheckboxGridصالحation لتطبيقها على هذا العنصر |
استرجاع الكرة
CheckboxGridItem
— جهاز CheckboxGridItem
هذا للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms