פריט פריסה שמציין את תחילת הדף. אפשר לגשת לפריטים או ליצור אותם דרך 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