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