Class 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 مع خيار تنقّل، سيتم تجاهل رمز التنقل هذا.

المعلَمات

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

الإرجاع

PageBreakItem — هذا الرمز PageBreakItem، لإنشاء سلسلة

التفويض

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

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

setGoToPage(navigationType)

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

المعلَمات

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

الإرجاع

PageBreakItem — هذا الرمز PageBreakItem، لإنشاء سلسلة

التفويض

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

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

setHelpText(text)

لضبط نص مساعدة العنصر (يُعرف هذا النص أحيانًا باسم نص الوصف لعناصر التنسيق، مثل ImageItems وPageBreakItems وSectionHeaderItems).

المعلَمات

الاسمالنوعالوصف
textStringنص المساعدة الجديد

الإرجاع

PageBreakItem — هذا الرمز PageBreakItem، لإنشاء سلسلة

التفويض

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

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

setTitle(title)

لضبط عنوان العنصر (يُشار إليه أحيانًا باسم نص العنوان في حال SectionHeaderItem)

المعلَمات

الاسمالنوعالوصف
titleStringالعنوان الجديد أو نص العنوان

الإرجاع

PageBreakItem — هذا الرمز PageBreakItem، لإنشاء سلسلة

التفويض

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

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