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)

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

المعلمات

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

الإرجاع

‫GridItem — هذا GridItem، للسلسلة

التفويض

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

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