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

Class CheckboxItem

פריט שאלה שמאפשר למשתמש לבחור תיבת סימון אחת או יותר, וגם שדה 'אחר' אופציונלי. אפשר לגשת לפריטים או ליצור אותם מ-Form. כשמשתמשים בפריטים כאלה במבחן, הם נבדקים באופן אוטומטי.

// Open a form by ID and add a new checkbox item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addCheckboxItem();
item.setTitle('What condiments would you like on your hot dog?')
    .setChoices([
      item.createChoice('Ketchup'),
      item.createChoice('Mustard'),
      item.createChoice('Relish'),
    ])
    .showOtherOption(true);

Methods

שיטה	סוג הערך המוחזר	תיאור קצר
`clearValidation()`	`CheckboxItem`	הסרת כל אימות הנתונים של הפריט הזה בתיבה.
`createChoice(value)`	`Choice`	יצירת אפשרות חדשה.
`createChoice(value, isCorrect)`	`Choice`	יצירת אפשרות חדשה.
`createResponse(responses)`	`ItemResponse`	יצירת `ItemResponse` חדש לפריט התיבה הסימון הזה.
`duplicate()`	`CheckboxItem`	יצירת עותק של הפריט הזה והוספתו לסוף הטופס.
`getChoices()`	`Choice[]`	הפונקציה מקבלת את כל האפשרויות לפריט.
`getFeedbackForCorrect()`	`QuizFeedback`	הפונקציה מחזירה את המשוב שמוצג למשתתפים כשהם משיבים נכון לשאלה.
`getFeedbackForIncorrect()`	`QuizFeedback`	הפונקציה מחזירה את המשוב שמוצג למשתתפים כשהם משיבים בצורה שגויה על שאלה.
`getHelpText()`	`String`	הפונקציה מקבלת את טקסט העזרה של הפריט (לפעמים נקרא טקסט תיאור לפריטי פריסה כמו `ImageItems`,‏ `PageBreakItems` ו-`SectionHeaderItems`).
`getId()`	`Integer`	הפונקציה מקבלת את המזהה הייחודי של הפריט.
`getIndex()`	`Integer`	הפונקציה מקבלת את האינדקס של הפריט מבין כל הפריטים בטופס.
`getPoints()`	`Integer`	הפונקציה מחזירה את ערך הנקודות של פריט שאפשר לתת עליו ציון.
`getTitle()`	`String`	הפונקציה מקבלת את שם הפריט (לפעמים נקרא טקסט כותרת, במקרה של `SectionHeaderItem`).
`getType()`	`ItemType`	הפונקציה מקבלת את סוג הפריט, שמיוצג כ-`ItemType`.
`hasOtherOption()`	`Boolean`	קובע אם יש לפריט אפשרות 'אחר'.
`isRequired()`	`Boolean`	קובע אם המשיב חייב לענות על השאלה.
`setChoiceValues(values)`	`CheckboxItem`	הגדרת האפשרויות לפריט מתוך מערך של מחרוזות.
`setChoices(choices)`	`CheckboxItem`	הגדרת מערך של אפשרויות לפריט.
`setFeedbackForCorrect(feedback)`	`CheckboxItem`	הגדרת המשוב שיוצג למשתתפים כשהם משיבים נכון לשאלה.
`setFeedbackForIncorrect(feedback)`	`CheckboxItem`	הגדרת המשוב שיוצג למשתתפים כשהם נותנים תשובה שגויה לשאלה.
`setHelpText(text)`	`CheckboxItem`	מגדיר את טקסט העזרה של הפריט (לפעמים נקרא טקסט תיאור לפריטי פריסה כמו `ImageItems`,‏ `PageBreakItems` ו-`SectionHeaderItems`).
`setPoints(points)`	`CheckboxItem`	הגדרת מספר הנקודות שפריט שניתן להגיש עליו מטלה שווה.
`setRequired(enabled)`	`CheckboxItem`	מגדיר אם המשיב חייב לענות על השאלה.
`setTitle(title)`	`CheckboxItem`	הגדרת שם הפריט (לפעמים נקרא טקסט כותרת, במקרה של `SectionHeaderItem`).
`setValidation(validation)`	`CheckboxItem`	הגדרת אימות הנתונים של תיבת הסימון הזו.
`showOtherOption(enabled)`	`CheckboxItem`	מגדיר אם לפריט יש אפשרות 'אחר'.

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

`clearValidation()`

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

חזרה

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

אישור

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

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

`createChoice(value)`

יצירת אפשרות חדשה.

פרמטרים

שם	סוג	תיאור
`value`	`String`	ערך הבחירה, שמוצג למשיבים בתור תווית כשהם צופים בטופס

חזרה

Choice – האפשרות החדשה

אישור

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

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

`createChoice(value, isCorrect)`

יצירת אפשרות חדשה.

פרמטרים

שם	סוג	תיאור
`value`	`String`	ערך הבחירה, שמוצג למשיבים בתור תווית כשהם צופים בטופס
`isCorrect`	`Boolean`	אם הבחירה היא תשובה נכונה

חזרה

Choice – האפשרות החדשה

אישור

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

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

`createResponse(responses)`

יצירת ItemResponse חדש לפריט התיבה הסימון הזה. הארגומנט responses הוא מערך String[] שמכיל ערכים שצריך לבדוק. הפונקציה מפעילה חריגה אם ערך כלשהו לא תואם לאפשרות חוקית לפריט הזה, אלא אם הערך של showOtherOption(enabled) מוגדר כ-true.

פרמטרים

שם	סוג	תיאור
`responses`	`String[]`	מערך של תשובות חוקיות לפריט הזה של שאלה אמריקאית

חזרה

ItemResponse – התגובה של הפריט

אישור

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

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

`duplicate()`

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

חזרה

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

אישור

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

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

`getChoices()`

הפונקציה מקבלת את כל האפשרויות לפריט.

חזרה

Choice[] – מערך של אפשרויות

אישור

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

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

`getFeedbackForCorrect()`

הפונקציה מחזירה את המשוב שמוצג למשתתפים כשהם משיבים נכון לשאלה.

חזרה

QuizFeedback – המשוב, אם יש כזה.

אישור

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

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

`getFeedbackForIncorrect()`

הפונקציה מחזירה את המשוב שמוצג למשתתפים כשהם משיבים בצורה שגויה על שאלה.

חזרה

QuizFeedback – המשוב, אם יש כזה.

אישור

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

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

`getPoints()`

הפונקציה מחזירה את ערך הנקודות של פריט שאפשר לתת עליו ציון.

חזרה

Integer – מספר הנקודות ששווה תשובה נכונה.

אישור

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

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

`hasOtherOption()`

קובע אם יש לפריט אפשרות 'אחר'.

חזרה

Boolean — true אם יש לפריט אפשרות 'אחר', false אם לא

אישור

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

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

`setChoiceValues(values)`

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

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoiceValues(['Dogs', 'Cats']);

פרמטרים

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

חזרה

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

אישור

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

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

`setChoices(choices)`

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

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
item.setChoices([item.createChoice('Cats'), item.createChoice('Dogs')]);

פרמטרים

שם	סוג	תיאור
`choices`	`Choice[]`	מערך של אפשרויות

חזרה

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

זריקות

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

אישור

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

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

`setFeedbackForCorrect(feedback)`

הגדרת המשוב שיוצג למשתתפים כשהם משיבים נכון לשאלה.

// Open a form by ID and add a new list item.
const form = FormApp.openById('1234567890abcdefghijklmnopqrstuvwxyz');
const item = form.addListItem();
item.setTitle('Do you prefer cats or dogs?');
// Set "Dogs" as the correct answer to this question.
item.setChoices([
  item.createChoice('Dogs', true),
  item.createChoice('Cats', false),
]);
// Add feedback which will be shown for correct responses; ie "Dogs".
item.setFeedbackForCorrect(
    FormApp.createFeedback().setDisplayText('Dogs rule, cats drool.').build(),
);

פרמטרים

שם	סוג	תיאור
`feedback`	`QuizFeedback`	המשוב החדש. ערך null ימחק את המשוב.

חזרה

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

אישור

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

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

`setFeedbackForIncorrect(feedback)`

הגדרת המשוב שיוצג למשתתפים כשהם נותנים תשובה שגויה לשאלה.

פרמטרים

שם	סוג	תיאור
`feedback`	`QuizFeedback`	המשוב החדש

חזרה

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

אישור

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

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

`setHelpText(text)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setPoints(points)`

הגדרת מספר הנקודות שפריט שניתן להגיש עליו מטלה שווה. ערך ברירת המחדל לפריטים חדשים הוא 0.

פרמטרים

שם	סוג	תיאור
`points`	`Integer`	מספר הנקודות שמשויכות לפריט השאלה

חזרה

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

אישור

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

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

`setRequired(enabled)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setTitle(title)`

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

פרמטרים

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

חזרה

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

אישור

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

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

`setValidation(validation)`

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

פרמטרים

שם	סוג	תיאור
`validation`	`CheckboxValidation`	CheckboxValidation שיחול על הפריט הזה.

חזרה

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

אישור

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

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

`showOtherOption(enabled)`

מגדיר אם לפריט יש אפשרות 'אחר'. ערך ברירת המחדל של CheckboxItem או MultipleChoiceItem חדשים הוא false.

פרמטרים

שם	סוג	תיאור
`enabled`	`Boolean`	`true` אם יש לפריט אפשרות 'אחר', `false` אם לא

חזרה

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

אישור

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

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