Class GridItem

الشبكةالعنصر

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

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const 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	عنصر GridValidation لتطبيقه على هذا العنصر

الإرجاع

GridItem — هذا GridItem، لإنشاء سلسلة

التفويض

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

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