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

المَعلمات

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

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

المَعلمات

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

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

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

الرميات

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

التفويض

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

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

`setHelpText(text)`

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

المَعلمات

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

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

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

التفويض

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

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

`setRequired(enabled)`

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

المَعلمات

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

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

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

التفويض

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

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

`setRows(rows)`

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

المَعلمات

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

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

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

الرميات

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

التفويض

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

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

`setTitle(title)`

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

المَعلمات

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

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

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

التفويض

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

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

`setValidation(validation)`

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

المَعلمات

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

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

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

التفويض

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

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