عنصر تخطيط يحدد بداية الصفحة. يمكن الوصول إلى العناصر أو إنشاؤها من Form
.
// Create a form and add three page-break items. var form = FormApp.create('Form Name'); var pageTwo = form.addPageBreakItem().setTitle('Page Two'); var pageThree = form.addPageBreakItem().setTitle('Page Three'); // Make the first two pages navigate elsewhere upon completion. pageTwo.setGoToPage(pageThree); // At end of page one (start of page two), jump to page three pageThree.setGoToPage(FormApp.PageNavigationType.RESTART); // At end of page two, restart form
الطُرق
الطريقة | نوع الإرجاع | وصف قصير |
---|---|---|
duplicate() | PageBreakItem | إنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج |
getGoToPage() | PageBreakItem | الحصول على PageBreakItem الذي سينتقل إليه النموذج بعد إكمال الصفحة قبل هذا
فاصل صفحة (أي عند الوصول إلى فاصل الصفحة هذا عن طريق التقدم الخطي الطبيعي خلال
النموذج). |
getHelpText() | String | تحصل على نص المساعدة الخاص بالعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل ImageItems وPageBreakItems وSectionHeaderItems ). |
getId() | Integer | الحصول على المعرّف الفريد للعنصر |
getIndex() | Integer | الحصول على فهرس العنصر بين جميع العناصر في النموذج. |
getPageNavigationType() | PageNavigationType | الحصول على نوع التنقل في الصفحة الذي يحدث بعد إكمال الصفحة قبل فاصل الصفحة هذا (أي عند الوصول إلى فاصل الصفحة هذا من خلال التقدم الخطي الطبيعي عبر النموذج). |
getTitle() | String | يحصل على عنوان العنصر (يُسمى أحيانًا نص العنوان، في حالة استخدام SectionHeaderItem ). |
getType() | ItemType | تعرض هذه السمة نوع العنصر، ويتم تمثيله على أنّه ItemType . |
setGoToPage(goToPageItem) | PageBreakItem | تعمل على تعيين الصفحة للانتقال إليها بعد إكمال الصفحة قبل فاصل الصفحة (أي عند للوصول إلى فاصل الصفحة هذا من خلال التقدم الخطي العادي خلال النموذج). |
setGoToPage(navigationType) | PageBreakItem | لتحديد نوع التنقل في الصفحة الذي يحدث بعد إكمال الصفحة قبل فاصل الصفحات هذا (أي عند الوصول إلى فاصل الصفحة هذا من خلال التقدم الخطي الطبيعي عبر النموذج). |
setHelpText(text) | PageBreakItem | تحدِّد هذه السياسة نص المساعدة للعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل ImageItems وPageBreakItems وSectionHeaderItems ). |
setTitle(title) | PageBreakItem | تضبط عنوان العنصر (يُسمّى أحيانًا نص العنوان، في حال استخدام SectionHeaderItem ). |
الوثائق التفصيلية
duplicate()
إنشاء نسخة من هذا العنصر وإلحاقها بنهاية النموذج
الإرجاع
PageBreakItem
— نسخة طبق الأصل من PageBreakItem
، للسلسلة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getGoToPage()
الحصول على PageBreakItem
الذي سينتقل إليه النموذج بعد إكمال الصفحة قبل هذا
فاصل صفحة (أي عند الوصول إلى فاصل الصفحة هذا عن طريق التقدم الخطي الطبيعي خلال
النموذج).
الإرجاع
PageBreakItem
— فاصل الصفحات المطلوب الانتقال إليه بعد إكمال الصفحة قبل فاصل الصفحة هذا، أو null
إذا لم يتم ضبط أي من هذه الخيارات
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
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()
setGoToPage(goToPageItem)
تعمل على تعيين الصفحة للانتقال إليها بعد إكمال الصفحة قبل فاصل الصفحة (أي عند
للوصول إلى فاصل الصفحة هذا من خلال التقدم الخطي العادي خلال النموذج). إذا كانت الصفحة السابقة
تحتوي على MultipleChoiceItem
أو ListItem
مع خيار تنقل، والذي
يتخطى التنقل هذا التنقل.
المعلمات
الاسم | النوع | الوصف |
---|---|---|
goToPageItem | PageBreakItem | فاصل الصفحة للانتقال إليه بعد إكمال الصفحة قبل فاصل الصفحة هذا |
الإرجاع
PageBreakItem
— PageBreakItem
هذا، للسلسلة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
تحدِّد هذه السياسة نص المساعدة للعنصر (يُسمّى أحيانًا نص الوصف لعناصر التنسيق مثل ImageItems
وPageBreakItems
وSectionHeaderItems
).
المعلمات
الاسم | النوع | الوصف |
---|---|---|
text | String | نص المساعدة الجديد |
الإرجاع
PageBreakItem
— PageBreakItem
هذا، للسلسلة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
تضبط عنوان العنصر (يُسمّى أحيانًا نص العنوان، في حال استخدام SectionHeaderItem
).
المعلمات
الاسم | النوع | الوصف |
---|---|---|
title | String | العنوان أو نص العنوان الجديد |
الإرجاع
PageBreakItem
— PageBreakItem
هذا، للسلسلة
التفويض
تتطلب النصوص البرمجية التي تستخدم هذه الطريقة إذنًا باستخدام واحد أو أكثر من النطاقات التالية:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms