Class PageBreakItem

PageBreakItem

عنصر تخطيط يحدد بداية الصفحة. يمكن الوصول إلى العناصر أو إنشاؤها من 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

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فاصل الصفحة للانتقال إليه بعد إكمال الصفحة قبل فاصل الصفحة هذا

الإرجاع

PageBreakItemPageBreakItem هذا، للسلسلة

التفويض

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

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

setGoToPage(navigationType)

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

المعلمات

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

الإرجاع

PageBreakItemPageBreakItem هذا، للسلسلة

التفويض

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

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

setHelpText(text)

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

المعلمات

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

الإرجاع

PageBreakItemPageBreakItem هذا، للسلسلة

التفويض

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

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

setTitle(title)

تضبط عنوان العنصر (يُسمّى أحيانًا نص العنوان، في حال استخدام SectionHeaderItem).

المعلمات

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

الإرجاع

PageBreakItemPageBreakItem هذا، للسلسلة

التفويض

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

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