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

Class GridItem

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

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

שיטות

שיטה	סוג הערך המוחזר	תיאור קצר
`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 או אימות ללא נדרשות פונקציות שנקראות כאן, יסירו את כל האימות הקודם.

פרמטרים

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

חזרה

GridItem – הGridItem הזה, לשרשור

אישור

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

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