Class PageBreakItem

PageBreakItem

عنصر تخطيط يحدّد بداية الصفحة. يمكن الوصول إلى العناصر أو إنشاؤها من Form.

// Create a form and add three page-break items.
const form = FormApp.create('Form Name');
const pageTwo = form.addPageBreakItem().setTitle('Page Two');
const 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

---

getPageNavigationType()

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

الإرجاع

‫PageNavigationType: إجراء التنقّل الذي يجب اتّخاذه بعد إكمال الصفحة قبل فاصل الصفحة هذا

التفويض

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

• 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

---

setGoToPage(goToPageItem)

تضبط هذه السمة الصفحة للانتقال إليها بعد إكمال الصفحة التي تسبق فاصل الصفحة هذا (أي عند الوصول إلى فاصل الصفحة هذا من خلال التقدّم الخطي العادي في النموذج). إذا كانت الصفحة السابقة تحتوي على MultipleChoiceItem أو ListItem مع خيار تنقّل، سيتجاوز هذا التنقّل التنقّل الحالي.

المَعلمات

الاسم	النوع	الوصف
goToPageItem	PageBreakItem	فاصل الصفحة الذي سيتم الانتقال إليه بعد إكمال الصفحة التي تسبق فاصل الصفحة هذا

الإرجاع

‫PageBreakItem — هذا PageBreakItem، للسلاسل

التفويض

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

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

---

setGoToPage(navigationType)

تضبط هذه السمة نوع التنقّل في الصفحة الذي يحدث بعد إكمال الصفحة التي تسبق فاصل الصفحات هذا (أي عند الوصول إلى فاصل الصفحات هذا من خلال التقدّم الخطي العادي في النموذج). إذا كانت الصفحة تحتوي على MultipleChoiceItem أو ListItem مع خيار تنقّل، سيحلّ هذا التنقّل محلّ التنقّل الحالي.

المَعلمات

الاسم	النوع	الوصف
navigationType	PageNavigationType	إجراء التنقّل الذي يجب اتّخاذه بعد إكمال الصفحة التي تسبق فاصل الصفحة هذا

الإرجاع

‫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