عنصر نموذج عام يحتوي على خصائص شائعة لكل العناصر، مثل العنوان ونص المساعدة.
يمكن الوصول إلى العناصر أو إنشاؤها من "Form
".
للعمل على السمات الخاصة بالنوع، استخدِم getType()
للتحقق من ItemType
للعنصر، ثم بث العنصر إلى الفئة المناسبة باستخدام طريقة مثل asCheckboxItem()
.
// Create a new form and add a text item. var form = FormApp.create('Form Name'); form.addTextItem(); // Access the text item as a generic item. var items = form.getItems(); var item = items[0]; // Cast the generic item to the text-item class. if (item.getType() == 'TEXT') { var textItem = item.asTextItem(); textItem.setRequired(false); }
تنفيذ الصفوف
الاسم | وصف قصير |
---|
الطُرق
الطريقة | نوع القيمة التي يتم إرجاعها | وصف قصير |
---|---|---|
asCheckboxGridItem() | CheckboxGridItem | يتم عرض السلعة كعنصر شبكة مربّع اختيار. |
asCheckboxItem() | CheckboxItem | يتم عرض العنصر كعنصر مربّع اختيار. |
asDateItem() | DateItem | لعرض السلعة كعنصر تاريخ. |
asDateTimeItem() | DateTimeItem | لعرض العنصر كعنصر تاريخ ووقت. |
asDurationItem() | DurationItem | لعرض السلعة كعنصر مدة |
asGridItem() | GridItem | يتم عرض السلعة كعنصر شبكة. |
asImageItem() | ImageItem | لعرض السلعة على شكل صورة. |
asListItem() | ListItem | لعرض العنصر كعنصر قائمة. |
asMultipleChoiceItem() | MultipleChoiceItem | تعرِض السلعة كعنصر متعدد الخيارات. |
asPageBreakItem() | PageBreakItem | لعرض العنصر كعنصر فاصل صفحات. |
asParagraphTextItem() | ParagraphTextItem | لعرض العنصر كعنصر نص فقرة. |
asScaleItem() | ScaleItem | لعرض العنصر كعنصر مقياس. |
asSectionHeaderItem() | SectionHeaderItem | لعرض العنصر كعنصر عنوان القسم. |
asTextItem() | TextItem | لعرض العنصر كعنصر نصي. |
asTimeItem() | TimeItem | لعرض السلعة كعنصر زمني. |
asVideoItem() | VideoItem | لعرض السلعة كعنصر فيديو. |
duplicate() | Item | لإنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج |
getHelpText() | String | الحصول على نص المساعدة الخاص بالعنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems ). |
getId() | Integer | الحصول على المعرّف الفريد للسلعة |
getIndex() | Integer | للحصول على فهرس العنصر بين جميع العناصر في النموذج. |
getTitle() | String | الحصول على عنوان العنصر (يُسمّى أحيانًا نص العنوان في حال استخدام SectionHeaderItem ) |
getType() | ItemType | تحصل على نوع العنصر، ويتم تمثيله بعلامة ItemType . |
setHelpText(text) | Item | تعمل هذه السياسة على ضبط نص المساعدة الخاص بالعنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems ). |
setTitle(title) | Item | لضبط عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem ). |
الوثائق التفصيلية
asCheckboxGridItem()
يتم عرض السلعة كعنصر شبكة مربّع اختيار. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي CHECKBOX_GRID
من قبل.
استرجاع الكرة
CheckboxGridItem
— عنصر الشبكة في مربّع الاختيار
الرميات
Error
: إذا لم يكن العنصر عنصرًا في شبكة مربّعات اختيار
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asCheckboxItem()
يتم عرض العنصر كعنصر مربّع اختيار. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي CHECKBOX
من قبل.
استرجاع الكرة
CheckboxItem
— عنصر مربّع الاختيار
الرميات
Error
: إذا لم يكن العنصر مربّع اختيار
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDateItem()
لعرض السلعة كعنصر تاريخ. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي DATE
من قبل.
استرجاع الكرة
DateItem
— عنصر التاريخ
الرميات
Error
: إذا لم يكن العنصر عنصر تاريخ
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDateTimeItem()
لعرض العنصر كعنصر تاريخ ووقت. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي DATETIME
من قبل.
استرجاع الكرة
DateTimeItem
— عنصر التاريخ والوقت
الرميات
Error
: إذا لم يكن العنصر عنصرًا في تاريخ ووقت
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asDurationItem()
لعرض السلعة كعنصر مدة تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي DURATION
من قبل.
استرجاع الكرة
DurationItem
— عنصر المدة
الرميات
Error
: إذا لم يكن العنصر عبارة عن مدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asGridItem()
يتم عرض السلعة كعنصر شبكة. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي GRID
من قبل.
استرجاع الكرة
GridItem
: عنصر الشبكة
الرميات
Error
: إذا لم يكن العنصر على شكل شبكة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asImageItem()
asListItem()
لعرض العنصر كعنصر قائمة. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي LIST
من قبل.
استرجاع الكرة
ListItem
- عنصر القائمة
الرميات
Error
: إذا لم يكن العنصر عنصرًا في قائمة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asMultipleChoiceItem()
تعرِض السلعة كعنصر متعدد الخيارات. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي MULTIPLE_CHOICE
من قبل.
استرجاع الكرة
MultipleChoiceItem
- عنصر الاختيار من متعدد
الرميات
Error
: إذا لم يكن العنصر بخيارات متعدّدة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asPageBreakItem()
لعرض العنصر كعنصر فاصل صفحات. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي PAGE_BREAK
من قبل.
استرجاع الكرة
PageBreakItem
— عنصر فاصل الصفحات
الرميات
Error
: إذا لم يكن العنصر عبارة عن فاصل صفحة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asParagraphTextItem()
لعرض العنصر كعنصر نص فقرة. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي PARAGRAPH_TEXT
من قبل.
استرجاع الكرة
ParagraphTextItem
- عنصر نص الفقرة
الرميات
Error
: إذا لم يكن العنصر عبارة عن فقرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asScaleItem()
لعرض العنصر كعنصر مقياس. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي SCALE
من قبل.
استرجاع الكرة
ScaleItem
- عنصر المقياس
الرميات
Error
: إذا لم يكن العنصر عنصرًا مقياسًا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asSectionHeaderItem()
لعرض العنصر كعنصر عنوان القسم. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي SECTION_HEADER
من قبل.
استرجاع الكرة
SectionHeaderItem
— عنصر عنوان القسم
الرميات
Error
: إذا لم يكن العنصر عنوانًا لقسم
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asTextItem()
لعرض العنصر كعنصر نصي. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي TEXT
من قبل.
استرجاع الكرة
TextItem
- العنصر النصي
الرميات
Error
: إذا لم يكن العنصر نصًا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asTimeItem()
لعرض السلعة كعنصر زمني. تعرض استثناءات برمجة نصية إذا لم تكن ItemType
هي TIME
من قبل.
استرجاع الكرة
TimeItem
— عنصر الوقت
الرميات
Error
: إذا لم يكن العنصر عنصرًا زمنيًا
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
asVideoItem()
duplicate()
لإنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج
استرجاع الكرة
Item
: نسخة طبق الأصل من Item
، للتسلسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
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
getTitle()
الحصول على عنوان العنصر (يُسمّى أحيانًا نص العنوان في حال استخدام SectionHeaderItem
)
استرجاع الكرة
String
: عنوان العنصر أو نص عنوانه
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getType()
setHelpText(text)
تعمل هذه السياسة على ضبط نص المساعدة الخاص بالعنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems
وPageBreakItems
وSectionHeaderItems
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
text | String | نص المساعدة الجديد |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
لضبط عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem
).
المَعلمات
الاسم | Type | الوصف |
---|---|---|
title | String | العنوان الجديد أو نص العنوان |
استرجاع الكرة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة الحصول على تفويض باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms