یک آیتم طرح بندی که شروع یک صفحه را نشان می دهد. آیتم ها را می توان از یک 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