عنصر تنسيق يشير إلى بداية قسم بشكل مرئي. يمكن الوصول إلى العناصر أو إنشاؤها من
Form
.
// Open a form by ID and add a new section header. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addSectionHeaderItem(); item.setTitle('Title of new section');
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
duplicate() | SectionHeaderItem | إنشاء نسخة من هذا العنصر وإلحاقه بنهاية النموذج. |
getHelpText() | String | الحصول على نص المساعدة للعنصر (يُطلق عليه أحيانًا اسم الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems ). |
getId() | Integer | للحصول على المعرّف الفريد للعنصر. |
getIndex() | Integer | للحصول على فهرس العنصر بين جميع العناصر في النموذج. |
getTitle() | String | يحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem ). |
getType() | ItemType | تحصل على نوع العنصر، ويمثل ItemType . |
setHelpText(text) | SectionHeaderItem | تُحدِّد نص مساعدة العنصر (يُسمى أحيانًا نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems ). |
setTitle(title) | SectionHeaderItem | تحدد عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem ). |
المستندات التفصيلية
duplicate()
إنشاء نسخة من هذا العنصر وإلحاقه بنهاية النموذج.
تذكرة ذهاب وعودة
SectionHeaderItem
- نسخة طبق الأصل من هذا SectionHeaderItem
، للسلسلة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
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
).
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
text | String | نص المساعدة الجديد |
تذكرة ذهاب وعودة
SectionHeaderItem
- هذا SectionHeaderItem
، للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
تحدد عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة SectionHeaderItem
).
المعلّمات
الاسم | النوع | الوصف |
---|---|---|
title | String | العنوان الجديد أو نص العنوان الجديد |
تذكرة ذهاب وعودة
SectionHeaderItem
- هذا SectionHeaderItem
، للسلاسل
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة تفويضًا مع واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms