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

Class GridItem

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

// Open a form by ID and add a new grid item.
var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
var item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

الطُرق

الطريقة	نوع الإرجاع	وصف قصير
`clearValidation()`	`GridItem`	إزالة أي تحقق من صحة بيانات عنصر الشبكة هذا.
`createResponse(responses)`	`ItemResponse`	تنشئ علامة `ItemResponse` جديدة لعنصر الشبكة هذا.
`duplicate()`	`GridItem`	إنشاء نسخة من هذا العنصر وإلحاقه بنهاية النموذج.
`getColumns()`	`String[]`	الحصول على القيم لكل عمود في الشبكة.
`getHelpText()`	`String`	الحصول على نص المساعدة للعنصر (يُطلق عليه أحيانًا اسم الوصف لعناصر التنسيق، مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`getId()`	`Integer`	للحصول على المعرّف الفريد للعنصر.
`getIndex()`	`Integer`	للحصول على فهرس العنصر بين جميع العناصر في النموذج.
`getRows()`	`String[]`	وللحصول على قيم كل صف في الشبكة.
`getTitle()`	`String`	يحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة `SectionHeaderItem`).
`getType()`	`ItemType`	تحصل على نوع العنصر، ويمثل `ItemType`.
`isRequired()`	`Boolean`	يحدّد ما إذا كان يجب على المجيب أن يجيب عن السؤال.
`setColumns(columns)`	`GridItem`	تعمل هذه السياسة على ضبط أعمدة الشبكة استنادًا إلى مصفوفة من القيم.
`setHelpText(text)`	`GridItem`	تُحدِّد نص مساعدة العنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل `ImageItems` و`PageBreakItems` و`SectionHeaderItems`).
`setRequired(enabled)`	`GridItem`	يحدّد هذا الإعداد ما إذا كان على المجيب الإجابة عن السؤال.
`setRows(rows)`	`GridItem`	لضبط صفوف الشبكة استنادًا إلى مصفوفة من القيم.
`setTitle(title)`	`GridItem`	تحدد عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة `SectionHeaderItem`).
`setValidation(validation)`	`GridItem`	لضبط التحقُّق من بيانات عنصر الشبكة هذا.

المستندات التفصيلية

`clearValidation()`

إزالة أي تحقق من صحة بيانات عنصر الشبكة هذا.

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

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

التفويض

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

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()`

إنشاء نسخة من هذا العنصر وإلحاقه بنهاية النموذج.

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

GridItem - نسخة طبق الأصل من هذا GridItem، للسلسلة

التفويض

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

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[]`	مصفوفة من قيم الأعمدة التي يراها المجيبون كتصنيفات عند عرض النموذج

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

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

طرح

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

التفويض

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

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

`setHelpText(text)`

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

المعلّمات

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

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

GridItem - هذا GridItem، للسلاسل

التفويض

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

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

`setRequired(enabled)`

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

المعلّمات

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

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

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

التفويض

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

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

`setRows(rows)`

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

المعلّمات

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

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

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

طرح

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

التفويض

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

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

`setTitle(title)`

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

المعلّمات

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

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

GridItem - هذا GridItem، للسلاسل

التفويض

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

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

`setValidation(validation)`

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

المعلّمات

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

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

GridItem - هذا GridItem، للسلاسل

التفويض

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

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