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

Class CheckboxGridItem

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

// Open a form by ID and add a new checkbox 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()`

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

חזרה

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`	CheckboxGrid Validation שיש להחיל על הפריט הזה.

חזרה

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

אישור

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

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