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() Page Break Item یک کپی از این آیتم ایجاد می‌کند و آن را به انتهای فرم اضافه می‌کند.
get Go To Page() Page Break Item Page Break Item را که فرم پس از تکمیل صفحه قبل از این شکست صفحه (یعنی با رسیدن به این شکست صفحه با پیشرفت خطی عادی در طول فرم) به آن پرش می‌کند، دریافت می‌کند.
get Help Text() String متن راهنمای آیتم (که گاهی اوقات برای آیتم‌های طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items متن توضیحات نامیده می‌شود) را دریافت می‌کند.
get Id() Integer شناسه منحصر به فرد کالا را دریافت می‌کند.
get Index() Integer اندیس آیتم را از بین تمام آیتم‌های موجود در فرم دریافت می‌کند.
get Page Navigation Type() Page Navigation Type نوع پیمایش صفحه‌ای را که پس از تکمیل صفحه قبل از این شکست صفحه رخ می‌دهد، دریافت می‌کند (یعنی، پس از رسیدن به این شکست صفحه با پیشرفت خطی عادی در فرم).
get Title() String عنوان آیتم (که گاهی اوقات در مورد Section Header Item ، متن سربرگ نامیده می‌شود) را برمی‌گرداند.
get Type() Item Type نوع آیتم را که به صورت Item Type نمایش داده می‌شود، دریافت می‌کند.
set Go To Page(goToPageItem) Page Break Item تنظیم می‌کند که پس از تکمیل صفحه قبل از این شکست صفحه (یعنی با رسیدن به این شکست صفحه با پیشرفت خطی عادی در فرم)، به صفحه مورد نظر پرش شود.
set Go To Page(navigationType) Page Break Item نوع پیمایش صفحه را که پس از تکمیل صفحه قبل از این شکست صفحه (یعنی پس از رسیدن به این شکست صفحه با پیشرفت خطی عادی در فرم) رخ می‌دهد، تنظیم می‌کند.
set Help Text(text) Page Break Item متن راهنمای آیتم را تنظیم می‌کند (گاهی اوقات برای آیتم‌های طرح‌بندی مانند Image Items ، Page Break Items و Section Header Items متن توضیحات نامیده می‌شود).
set Title(title) Page Break Item عنوان آیتم را تنظیم می‌کند (که گاهی اوقات در مورد Section Header Item ، متن سربرگ نامیده می‌شود).

مستندات دقیق

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 با گزینه ناوبری بود، آن ناوبری، این ناوبری را لغو می‌کند.

پارامترها

نام نوع توضیحات
go To Page Item Page Break Item پرش به صفحه قبل از این پرش صفحه پس از تکمیل صفحه

بازگشت

PageBreakItem — این PageBreakItem ، برای زنجیره‌سازی

مجوز

اسکریپت‌هایی که از این روش استفاده می‌کنند، نیاز به مجوز با یک یا چند مورد از حوزه‌های زیر دارند:

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

setGoToPage(navigationType)

نوع پیمایش صفحه را که پس از تکمیل صفحه قبل از این شکست صفحه رخ می‌دهد (یعنی، پس از رسیدن به این شکست صفحه با پیشرفت خطی عادی در فرم) تنظیم می‌کند. اگر صفحه حاوی یک MultipleChoiceItem یا ListItem با گزینه پیمایش باشد، آن پیمایش، این پیمایش را لغو می‌کند.

پارامترها

نام نوع توضیحات
navigation Type Page Navigation Type اقدام ناوبری که پس از تکمیل صفحه قبل از این شکست صفحه انجام می‌شود

بازگشت

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