דף זה תורגם על ידי Cloud Translation API.

Class GridItem

פריט שאלה שמוצג כרשימה של עמודות ושורות, ומאפשר למשתמש לבחור אפשרות אחת לכל שורה מתוך רצף של לחצני בחירה. אפשר לגשת לפריטים או ליצור אותם מ-Form.

// Open a form by ID and add a new grid item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addGridItem();
item.setTitle('Rate your interests')
    .setRows(['Cars', 'Computers', 'Celebrities'])
    .setColumns(['Boring', 'So-so', 'Interesting']);

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`clearValidation()`	`GridItem`	הסרת כל אימות נתונים של פריט התצוגה הזה.
`createResponse(responses)`	`ItemResponse`	יצירת `ItemResponse` חדש לפריט הזה ברשימה.
`duplicate()`	`GridItem`	יצירת עותק של הפריט הזה והוספתו לסוף הטופס.
`getColumns()`	`String[]`	הפונקציה מקבלת את הערכים של כל עמודה ברשימה.
`getHelpText()`	`String`	הפונקציה מקבלת את טקסט העזרה של הפריט (לפעמים נקרא טקסט תיאור לפריטי פריסה כמו `ImageItems`,‏ `PageBreakItems` ו-`SectionHeaderItems`).
`getId()`	`Integer`	הפונקציה מקבלת את המזהה הייחודי של הפריט.
`getIndex()`	`Integer`	הפונקציה מקבלת את האינדקס של הפריט מבין כל הפריטים בטופס.
`getRows()`	`String[]`	הפונקציה מקבלת את הערכים של כל שורה ברשימה.
`getTitle()`	`String`	הפונקציה מקבלת את שם הפריט (לפעמים נקרא טקסט כותרת, במקרה של `SectionHeaderItem`).
`getType()`	`ItemType`	הפונקציה מקבלת את סוג הפריט, שמיוצג כ-`ItemType`.
`isRequired()`	`Boolean`	קובע אם המשיב חייב לענות על השאלה.
`setColumns(columns)`	`GridItem`	הגדרת העמודות של הרשת על סמך מערך ערכים.
`setHelpText(text)`	`GridItem`	מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט תיאור לפריטי פריסה כמו `ImageItems`,‏ `PageBreakItems` ו-`SectionHeaderItems`).
`setRequired(enabled)`	`GridItem`	מגדיר אם המשיב חייב לענות על השאלה.
`setRows(rows)`	`GridItem`	הגדרת השורות של התצוגה לפי מערך ערכים.
`setTitle(title)`	`GridItem`	הגדרת שם הפריט (לפעמים נקרא טקסט כותרת, במקרה של `SectionHeaderItem`).
`setValidation(validation)`	`GridItem`	הגדרת אימות הנתונים של פריט התצוגה הזה.

מסמכים מפורטים

`clearValidation()`

הסרת כל אימות נתונים של פריט התצוגה הזה.

חזרה

GridItem – הפריט הזה, לצורך קישור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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()`

יצירת עותק של הפריט הזה והוספתו לסוף הטופס.

חזרה

GridItem – עותק כפול של GridItem הזה, לצורך שרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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()`

הפונקציה מקבלת את סוג הפריט, שמיוצג כ-ItemType.

חזרה

ItemType – סוג הפריט

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

`isRequired()`

קובע אם המשיב חייב לענות על השאלה.

חזרה

Boolean – אם המשיב חייב להשיב על השאלה

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

`setColumns(columns)`

הגדרת העמודות של הרשת על סמך מערך ערכים. אם המערך ריק, מתבצעת הטלת חריגה.

פרמטרים

שם	סוג	תיאור
`columns`	`String[]`	מערך של ערכי עמודות, שהנשאלים רואים כתוויות כשהם צופים בטופס

חזרה

GridItem – הפריט הזה, לצורך קישור

זריקות

Error – אם המערך הנתון הוא null או ריק

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

`setHelpText(text)`

מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט תיאור לפריטי פריסה כמו ImageItems,‏ PageBreakItems ו-SectionHeaderItems).

פרמטרים

שם	סוג	תיאור
`text`	`String`	טקסט העזרה החדש

חזרה

GridItem — ה-GridItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

`setRequired(enabled)`

מגדיר אם המשיב חייב לענות על השאלה.

פרמטרים

שם	סוג	תיאור
`enabled`	`Boolean`	אם המשיב חייב להשיב על השאלה

חזרה

GridItem – הפריט הנוכחי (לשרשור)

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

`setRows(rows)`

הגדרת השורות של התצוגה לפי מערך ערכים. גורמת להשלכת חריגה אם המערך הנתון ריק.

פרמטרים

שם	סוג	תיאור
`rows`	`String[]`	מערך של ערכי שורות, שהנשאלים רואים כתוויות כשהם צופים בטופס

חזרה

GridItem – הפריט הזה, לצורך קישור

זריקות

Error – אם המערך הנתון הוא null או ריק

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

`setTitle(title)`

הגדרת שם הפריט (לפעמים נקרא טקסט כותרת, במקרה של SectionHeaderItem).

פרמטרים

שם	סוג	תיאור
`title`	`String`	הטקסט החדש של הכותרת או הכותרת הראשית

חזרה

GridItem — ה-GridItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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

`setValidation(validation)`

הגדרת אימות הנתונים של פריט התצוגה הזה. העברה של null או של אימות ללא קריאה לפונקציות require תגרום להסרת כל אימות קודם.

פרמטרים

שם	סוג	תיאור
`validation`	`GridValidation`	בדיקת תקינות של רשת שתחול על הפריט הזה.

חזרה

GridItem — ה-GridItem הזה, לשרשור

אישור

סקריפטים שמשתמשים בשיטה הזו דורשים הרשאה עם אחד או יותר מהיקפי הגישה הבאים:

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