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

Class CheckboxGridItem

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

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

הלוך ושוב

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

הרשאה

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

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