פריט שאלה מוצג כרשת של עמודות ושורות שמאפשר למשיבים לבחור מספר אפשרויות בכל שורה מתוך רצף של תיבות סימון. אפשר לגשת לפריטים או ליצור אותם דרך Form
.
// Open a form by ID and add a new checkgox grid item. var form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz'); var item = form.addCheckboxGridItem(); item.setTitle('Where did you celebrate New Years?') .setRows(['New York', 'San Francisco', 'London']) .setColumns(['2014', '2015', '2016', '2017']);
שיטות
שיטה | סוג הערך שמוחזר | תיאור קצר |
---|---|---|
clearValidation() | CheckboxGridItem | מסירה כל אימות נתונים עבור פריט הרשת הזה. |
createResponse(responses) | ItemResponse | יצירת ItemResponse חדש לפריט הזה ברשת תיבות סימון. |
duplicate() | CheckboxGridItem | יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס. |
getColumns() | String[] | הפונקציה מקבלת את הערכים של כל עמודה ברשת. |
getHelpText() | String | הפונקציה מקבלת את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' לפריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
getId() | Integer | הפונקציה מקבלת את המזהה הייחודי של הפריט. |
getIndex() | Integer | הפונקציה מקבלת את האינדקס של הפריט מבין כל הפריטים בטופס. |
getRows() | String[] | הפונקציה מקבלת את הערכים של כל שורה ברשת. |
getTitle() | String | הפונקציה מקבלת את הכותרת של הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem ). |
getType() | ItemType | הפונקציה מקבלת את סוג הפריט, שמיוצג כ-ItemType . |
isRequired() | Boolean | הגדרה זו קובעת אם המשיב חייב לענות על השאלה. |
setColumns(columns) | CheckboxGridItem | מגדירה את העמודות ברשת לפי מערך של ערכים. |
setHelpText(text) | CheckboxGridItem | מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems , PageBreakItems ו-SectionHeaderItems ). |
setRequired(enabled) | CheckboxGridItem | קובעת אם המשיב חייב לענות על השאלה. |
setRows(rows) | CheckboxGridItem | מגדירה את השורות ברשת לפי מערך של ערכים. |
setTitle(title) | CheckboxGridItem | מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem ). |
setValidation(validation) | CheckboxGridItem | מגדיר את אימות הנתונים של פריט הרשת בתיבת הסימון. |
תיעוד מפורט
clearValidation()
מסירה כל אימות נתונים עבור פריט הרשת הזה.
החזרות
CheckboxGridItem
– הפריט הזה לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
createResponse(responses)
יצירת ItemResponse
חדש לפריט הזה ברשת תיבות סימון. הארגומנט responses
חייב להיות מערך String[][]
של מערכים שמכילים את אותו מספר של ערכי הקלט ברשת תיבות הסימון. רכיב null
לשאלת רשת לא נדרשת של תיבות סימון
מצביע על 'אין תגובה' עבור השורה הזו. הפונקציה מוסיפה החרגה אם ערך כלשהו לא תואם לבחירה חוקית.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
responses | String[][] | מערך של מערכים של תשובות תקינות לפריט הזה ברשת של תיבות הסימון |
החזרות
ItemResponse
– התגובה של הפריט
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
duplicate()
יוצר עותק של פריט זה ומוסיף אותו לסוף הטופס.
החזרות
CheckboxGridItem
– עותק משוכפל של CheckboxGridItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
getColumns()
הפונקציה מקבלת את הערכים של כל עמודה ברשת.
החזרות
String[]
- מערך של ערכי עמודות, שהמשיבים רואים כתוויות בעת הצגת הטופס
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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
getRows()
הפונקציה מקבלת את הערכים של כל שורה ברשת.
החזרות
String[]
- מערך של ערכי שורה, שהמשיבים רואים כתוויות בעת הצגת הטופס
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
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()
isRequired()
הגדרה זו קובעת אם המשיב חייב לענות על השאלה.
החזרות
Boolean
– האם המשיב חייב לענות על השאלה
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setColumns(columns)
מגדירה את העמודות ברשת לפי מערך של ערכים. מוציא חריג אם המערך הנתון ריק.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
columns | String[] | מערך של ערכי עמודות, שאותם המשיבים רואים כתוויות בעת הצגת הטופס |
החזרות
CheckboxGridItem
– הפריט הזה לשרשור
קליעות
Error
– אם המערך הנתון הוא null
או שהוא ריק
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setHelpText(text)
מגדיר את טקסט העזרה של הפריט (נקרא לפעמים 'טקסט תיאור' עבור פריטי פריסה כמו ImageItems
, PageBreakItems
ו-SectionHeaderItems
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
text | String | טקסט העזרה החדש |
החזרות
CheckboxGridItem
— CheckboxGridItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRequired(enabled)
קובעת אם המשיב חייב לענות על השאלה.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
enabled | Boolean | האם המשיב חייב לענות על השאלה |
החזרות
CheckboxGridItem
– הפריט הנוכחי (לשרשור)
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setRows(rows)
מגדירה את השורות ברשת לפי מערך של ערכים. מוציא חריג אם המערך הנתון ריק.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
rows | String[] | מערך של ערכי שורה, שהמשיבים רואים כתוויות בעת הצגת הטופס |
החזרות
CheckboxGridItem
– הפריט הזה לשרשור
קליעות
Error
– אם המערך הנתון הוא null
או שהוא ריק
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setTitle(title)
מגדיר את כותרת הפריט (נקראת לפעמים טקסט כותרת, במקרה של SectionHeaderItem
).
פרמטרים
שם | תיאור | התיאור |
---|---|---|
title | String | הכותרת או הטקסט של הכותרת החדשה |
החזרות
CheckboxGridItem
— CheckboxGridItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms
setValidation(validation)
מגדיר את אימות הנתונים של פריט הרשת בתיבת הסימון. העברת ערך null או תיקוף ללא פונקציות נדרשות תגרום להסרת כל האימותים הקודמים.
פרמטרים
שם | תיאור | התיאור |
---|---|---|
validation | CheckboxGridValidation | תיבת CheckboxGridValidation שיש להחיל על פריט זה. |
החזרות
CheckboxGridItem
— CheckboxGridItem
, לשרשור
הרשאות
לסקריפטים שמשתמשים בשיטה הזו נדרשת הרשאה באחד או יותר מההיקפים הבאים:
-
https://www.googleapis.com/auth/forms.currentonly
-
https://www.googleapis.com/auth/forms