تمت ترجمة هذه الصفحة بواسطة Cloud Translation API‏.

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

المَعلمات

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

استرجاع الكرة

PageBreakItem — جهاز PageBreakItem هذا للسلاسل

التفويض

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

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

`setGoToPage(navigationType)`

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

المَعلمات

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

استرجاع الكرة

PageBreakItem — جهاز PageBreakItem هذا للسلاسل

التفويض

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

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

`setHelpText(text)`

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

المَعلمات

الاسم	Type	الوصف
`text`	`String`	نص المساعدة الجديد

استرجاع الكرة

PageBreakItem — جهاز PageBreakItem هذا للسلاسل

التفويض

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

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

`setTitle(title)`

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

المَعلمات

الاسم	Type	الوصف
`title`	`String`	العنوان الجديد أو نص العنوان

استرجاع الكرة

PageBreakItem — جهاز PageBreakItem هذا للسلاسل

التفويض

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

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