تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

المعلّمات

الاسم	النوع	الوصف
`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()`

تحصل على نوع العنصر، ويمثل 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)`

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

المعلّمات

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

تذكرة ذهاب وعودة

CheckboxGridItem — هذا العنصر، بالنسبة إلى السلاسل

طرح

Error — إذا كانت المصفوفة المحدّدة هي null أو فارغة

التفويض

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

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

`setHelpText(text)`

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

المعلّمات

الاسم	النوع	الوصف
`text`	`String`	نص المساعدة الجديد

تذكرة ذهاب وعودة

CheckboxGridItem - هذا CheckboxGridItem، للسلاسل

التفويض

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

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

`setRequired(enabled)`

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

المعلّمات

الاسم	النوع	الوصف
`enabled`	`Boolean`	ما إذا كان يجب على المُجيب الإجابة عن السؤال

تذكرة ذهاب وعودة

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

التفويض

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

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

`setRows(rows)`

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

المعلّمات

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

تذكرة ذهاب وعودة

CheckboxGridItem — هذا العنصر، بالنسبة إلى السلاسل

طرح

Error — إذا كانت المصفوفة المحدّدة هي null أو فارغة

التفويض

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

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

`setTitle(title)`

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

المعلّمات

الاسم	النوع	الوصف
`title`	`String`	العنوان الجديد أو نص العنوان الجديد

تذكرة ذهاب وعودة

CheckboxGridItem - هذا CheckboxGridItem، للسلاسل

التفويض

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

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

`setValidation(validation)`

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

المعلّمات

الاسم	النوع	الوصف
`validation`	`CheckboxGridValidation`	مربّع اختيار التحقق من الصحة لتطبيقه على هذا العنصر.

تذكرة ذهاب وعودة

CheckboxGridItem - هذا CheckboxGridItem، للسلاسل

التفويض

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

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